LSI-11 TYM8AS Hardware Config* Spec, 
introduction: 



Jan 13 1981 



Page 2 



1.0 Introduction 



This document describes tne hardware configuration specification for 
;tne TYrtBASes based on LSI-11 computers. 

It is assumed that tne reader is familiar with the architecture of the 
LSI-11 and that tne appropriate D£C hardware manuals are at hand and 
available for reference. 
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2.0 Components 

The following is a list of components which can be integrated into 
TYMBAS configurations. 

2.1 Processors 

two processor boards, can be used in a tymsas configuration, both are 
revisions of the KD11 module. These are the M7264 quad height board 
with on board memory and the M7270 dual height board/ both mentioned 
in the 1978-1979 edition of "Microcomputer Processors". 

2.2 Bootstraps 

The bootstrap board used in a TYMBASe configuration is tne BDVH-aa, 

Tne 8DV11 board is described in the 197H-1979 edition of "Memories 
and Peripherals". 

The bootstrap has a prom which resides on the board. This bootstrap 
allows the down line loading of the TYMBAS from TYMNET using LOADil 
or equivalent program, or from a connected host. Hosts currently 
supported are:-* 

1. Pdp-20 Tymcom-X 

2. Pdp-ii Rsx-llm 

3. Pdp-11 Rsts 

4. F3 Tenex 

The BDVU is a quad height board. 

2.3 Memories 

The TYMBASe is provided with either a 64K byte or 32K byte dual 
height MSVll-D or MSV11-E 18 bit MQS memory board. 

The Msvil memory is described in the 1978*1979 edition of "Memories 
and Peripherals" and both the MSV11 and the MXV11 are described in 
the 1979-1980 edition of "Microcomputer processor handbook". 

2.4 Asynchronous Interfaces 

Two serial asynchronous port options can be used in a TYMBAS. These 
are the DLY11-J and the 0ZV11. 
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The DLVll-J is a dual height module with 4 separate serial line 
units (SLU). A 0LV11 5LU interfaces one asynchronous serial line 
I/O device (either* 20ma or £IA) to the LSl-li bus (without modem 
control). une DLV11 port must be configured as a console terminal 
(cty). 

A DZV11 multiplexes asynchronous serial line I/O for 4 devices. It 
is a quad height module and has full modem control. 

2.5 synchronous interfaces 

Only one synchronous serial line interface is available for the 
TYMBAS configuration, the DUV~H. This is a quad height board 
described in the 1978-1979 edition of "Memories and Peripherals". 

2.6 Backplanes 

Two boxes can. be used for the ty.mbas configuration, the BAll-N or 
large 9 slot, and the PDP-ll/03 or small 4 slot box with an optional 
expansion box. These boxes are described in the 197y-l9«o edition 
of "Microcomputer interfaces Handbook". 

For the 9 slot box, the slots serviced by the (J-bus, are the 
leftmost two (as viewed from the rear of the box). The rightmost 
two slots do not interface to the bus. 



All slots in the 4 slot box (and the expansion box), are serviced by 
the Q-bus. 



LSI-ll TYMBAS Hardware Conflg. Spec, 
Configurations 



Jan 13 1^81 



Page 5 



3.0 Configurations 

Tnere are two possible configurations that can be supported by the 
TYMBAS software. These are detailed below, 

3.1 Large Box 

The modules in the large box are inserted as follows;- 

1. KDll processor 

2. MSVli memory board 

3. 0-2 DUVil synchronous serial interfaces 

4. 1-5 DLV11-J asynchronous serial interfaces 

5. 0-4 DZVil asynchronous multiplexors 

6. 1-2 DRVll parallel interfaces 

7. BDVll bootstrap board (with prom) 



I KDll I 11. 

+ -------...-----+-.•-.-.---.-.-•.+ 

I MSV11 I 12. 

+ ••.*. .———.•-.+•--•-•-.•.•«- „.+ 

I DUV11 I 3. 

+ — ———,•— -«« + ^.— —..»•.—«. .+ 

I DLVll-U/DUVll |4. 

I f 1)LV11~J / DZV11 I 5. 

I DLV11-J / OZV11 / DRVll I 6. 

I DLV11-J / DZV11 / DRVll I 7. 

i BDVll / DRVll i 3. 

I BDVll I 9. 

The DUVll(s) must be installed in the bus closest to the processor 
because this is the most time critical device. The BDVll acts as 
bus terminator, so it must always be inserted in the last slot after 
the other boards.. Cl.e." there must not exist any ^holes' in the 
bus). 
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3.2 Small box 

The insertion of boards in the small box 
follows:- 

1. KDll processor 

2. MSVll memory module 

3. 1-2 Duvn synchronous serial ports 

4. 1-5 DLV11-J 4 SLU module, 

5. 0-4 DZVll asynchronous multiplexors 

6. 1-2 DRVll parallel interface 

7. 1 Q bus expander 



(with expander) is as 



KDll 



MSVll 



-+ 
I 1. 



I (2 X DLV11-J)/ DZVll / DUVU I 2. 

+ ---<■-------------------—---'--+ 

I (2 X DLV11-J)/ DZVll /.DUVU I 3. 



•••••••••• 



I 



+-: 



+- : 



Expander; 



DLV11-J 



DLV11-J 



I 4. 

.«• + 

I 5. 



* DZVll / DRVll 
DZVll / 8DV11 / DRVil 
BDV11 



I 6. 
■ + 
I 7. 

I 8. 



All boards must be contiguous from slot 1. The DUVilcs) must be 
installed in the slot(s) closest to the processor because it is the 
most time critical device. If no bus expander is provided, then the 
BDV11 must be inserted into slot 4, and the DUVU in slot 2. 
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Configuring the Boards 

4.0 Configuring tne Boards 

Tnis section describes tne way in which the component boards must be 
configured to maKe them worK in a TYMBAS. 

It is assumed that the reader has nearby a copy of the relevant DEC 
reference nandboox. 

4.1 External Interfaces 

The following is a list of ^standard* addresses and vectors that can 
be assigned to various interface boards in a tymbas configuration. 



Device 


Address 


Vector 


ssssss 


SSS3SSS 


SS3SSS 


DRV11 


1 


167770 


330 


DKVU 


2 


167760 


40 


DRV11 


3 


167750 


50 


DRV11 


4 


167740 


70 


DUVU 


1 


160010 


400 


DUV11 


2 


160020 


410 


DUV11 


3 


160030 


420 


DUVU 


4 


160040 


430 


DZV11 


1 


160100 


440 


DZV11 


2 


160110 


450 


DZVU 


3 


160120 


460 


DZVU 


4 


160130 


470 


DLVU 


1 


176500 


300 






176510 


310 






176520 


320 


Ccty) 


177560 . 


60 


DLVU 


2 


176540 


340 






176550 


350 


.;- 




176560 


36.0 






176570 


370 


DLVU 


3 


176600 


140 






176610 


150 






176620 


160 






176630 


170 


DLVU 


4 


176640 


200 






176650 


210 






176660 


220 






176670 


230 


DLVU 


5 


176700 


240 






176710 


250 






176720 


260 






176730 


270 



These addresses and vectors must be observed for consistency. 
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4.2 Bootstrap 

1. Remove jumper fob 

2. Install jumper wu 

(If W13 does not exist on your board, carefully install the 
jumper as indicated in the DEC instaiation guide), 

3. Install the EPROM In the socket indicated (49). 

4. Configure both switches as indicated. 



\:/ 



Halt Run 
I / / 



\:/ 



1/ 



/ 



I I I i l 1 I I l I I I 
I I I I I I I I I i I I 

I I I I I I I I I I I I 



[J [] 
SI 82 

IEI 
111 
151 



I I I I I I I I I I I I 

I I I I I I I I I I I I 

I I I I I I I I I I I I 

o....o<--~ Install a jumper here 
... ... ... ... ... (W13) 

I I ID! I*| I I I l I l 

I I IEI l*l<— —————— install EPROM here 

i i i c i i * i . i i i i i i 



IEI 
... ... ... |3, 

I I I I IDi I I I I I | 0-12 1 

I I I I IEI I I I I I I .— >: 

I I I I IC! I I I | I I I : 

... ... ... ... ... ... j o-o 

Remove this I I I 
Jumper' (W5) --' --- 

IEI 
131 
111 



IEI 
121 
I 1 I 
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E21 switches are set as follows:- 

£21 
i o i o I o I l i o i 

12 3 4 5 
On = 1, Off a- 

E15 switch settings are as follows:- 

E15 

I1I1I0IOI1I0IOI0I 

^--.-.---.-— ——-••— »•------.+ 

123 45678 
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4.2 Synchronous Interface 

The DUVll is the only synchronous serial interface supported. The 
following defines the switch settinqs that must exist. 

1. Option. switches are set to allow single character synchronizing 
unless the connection is node to node (Remote nodes). 

E55 

I 1 I | ! X | I I I I 

12345678 
x <= l(on) if connection is to TYMNET else (off). 

2. Address and vector switches are set to the standard values. 

E38 
♦ -— — --<•---—•----------------+ 

iOIOIOtOiOIOIOIXl 

1234567b 
E39 

+ ----•--•—---—»-- — ---- — --—---+ 
I X I X I 1 I i I | X I X I 

12 3 4 5 6 7 8 

E38-8 => 1 for DUVll number 4 

else => 

E39-1 => 1 for DUVll number 2 and 3 

else s> o 

E39-2 => 1 for DUVll number 1 and 3 

else «> 

E39-3 = >* 1 for all DUVlls 

else «> 

£39-7 => 1 for DUVll number 3 and 4 

else => 

E39-8 => 1 for DUVll number 2 and 4 

else => 
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4.3 Parallel interfaces 

To set up the standard addresses and vectors on the dkvh, it is 
necessary to install and/or remove several wire straps, 

4.3,1 Address selection 

The DRVll address is encoded in 10 address straps Ai2 through A3, 
A12 being .the most significant. 



A3 





A9 


A4 


o' - 


A10 


A5 





All 


A6 





0---0 A12 


A7 







A8 








o A3 => install jumper for DRVH 2 and 4 
o A4 => install jumper for DRVll 3 land 4 
o A12 => Install jumper tor all DKVlis 

4.3.2 Vector selection 

Vector selection is accomplished by installing and/or removing 
straps^ between v7 through v3. 





V4 


o < 


D -.- V5 












V3 


( 
< 


D V6 
3 V7 













V3 => 


install 


jumper for 


DRVll 


2 









V4 s> 


Install 


jumper for 


DRVll 


2 and 


3 







V5 >> 


install 


jumper for 


DRVH 


1 









V6 = > 


install 


jumper for 


DRVll 


2, 3 


and 


4 





V7 => 


install 


jumper for 


DRVH 


2, 3 


and 


4 
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4.4 Asynchronous. Interfaces 
4.4.1 dlvii-j 

To set up the standard addresses and vectors for the 4 ports on 
the DLVll-d, it is necessary to jumper the board accordingly. 

1. Address selection 
o A12 => X to 1 

O All a> X tO 1 

A10 => X to 1 

A9 => X to 

A8 a> X to 1 

o A7 => remove jumper for DLVll l and 2 else install jumper. 

o A6 => remove jumper for DLVll 3 and 4 else install jumper. 

o A5 s> X to for DLVll 1, 3 and' 5 else X to 1. 

2. vector selection 

o V7 »> Installed for DLVll i, 2 , 4 and 5 else removed 
o V6 => installed for DLVll 1 , 2 and 3 else removed 
o vs s> X to for DLVll 1 

V5 =* X to 1 for DLVll 2 , 3 and 5 else removed 

3. Console selection 

o Cl => X to l for DLVll l else X to 

o C2 => X to 1 for DLVll 1 else X to 

o Breax selection (B X H) => Remove jumper 

4. Channel parameters 

For channels through 3; 
o E => X to 
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o => X to l 

o S => X to 

o P => X to 1 

5. Speed selection 

o U = 150 Baud 

o T =300 Baud 

o V s 600 Baud 

. o . W - 1200 Baud 

o Y a 2400 Baud 

o L = 4800 Baud 

. O N = 9600 Baud 

O K a 19200 Baud 

O Z a 38400 Baud 

Jumper from 0, 1, 2 or 3 to one or tne aoove to select 
"appropriate ciocx rate. 
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4.5.2 OZVU 

Addresses and vectors for DZVlls are set up as follows: 



1. Adaress selection 

£30 

lotoioioioioiiioixixi 

123456789 10 
E30-9 => l for DZVll number 3 and 4 
else => 

£30-10 »> 1 for DZVll number 2 and 4 
else -> 

2. Vector selection 

E2 

IIIOIOIXIXIXIOIOI 

1 2 3 4 5 6 7 8 

E2-4 => 1 for all DZVlls 

else => 

E2-5 => 1 for DZVll number 3 and 4 

else => 

E2-6 => 1 for OZVU number 2 and 4 

else => 
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1 INTRODUCTION 

This document tells you how to bring up a micronode TYMBASE* also 
called an LSIlit that Is down. The procedure documented here is 
very simple* but very important* for all information passed to and 
from the System XXV and the other AUGMENT hosts* as well as all 
interaction with individual users at their terminals* must go 
through the micronode. System XXV calls the micronode "TYMBftSE" 
and uses a program called "TYMSRV" to connect to it. Thus* when 
you see TYMBASE in a system message* it means the micronode; the 
term TYMSRV means the System XXV program that communicates with the 
mi cronode • 
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In some installations the System XXV and the micronode share one 
operator's terminal* In other installations* the System XXV and 
the micronode have separate terminals. As you work though the 
procedures in this document* you will notice steps labeled 
"[one-terminal ins ta I la ti ons l n • These steps apply only to 
inst al I at ions wi th one operator's terminal* they direct you to 
switch this terminal between connecting with the System XXV and the 
micronode. If your installation has separate terminals* you will 
not need to do this and should skip these steps. Other steps in 
the procedures wilt tell you to give a commmand on a particular 
terminal* either the system terminal or the micronode terminal. If 
your installation has separate terminals for the System XXV and the 
micronode* simply use the appropriate one. If your installation 
has only one terminal* do not worry? if you follow the steps for 
one-terminal installations your terminal will always be connected 
correct I y • 
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2 HOW TO TELL IF THE MICRONODE IS DOWN 

There is no one sure way to tell if the micronode is down* but the 
following symptoms mean it is not functioning properly and should 
be brought up with the procedure in section 3. 

1) The System XXV operators terminal repeatedly prints messages 
indicating problems with TYMBASE or TYMSRV. For example* 
"TYMBASE APPARENTLY DISABLED" or "TYMSRV: FAILED TO RESYNC WITH 
NODE". 

2) You are getting irate calls from users who cannot reach the 
System XXV or have been detached. 



3) The micronode's RUN light is off* 
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3 BRINGING UP THE MICRONODE 



3.1 Introduction 



Because the micronode connects users to the System XXV* before 
bringing it up and opening the system to users* you should 
always make sure the system is operating correctly. (See 
"System XXV Failure Recovery Procedures" for instructions on 
bringing the system up after a crash*) Once you know the system 
is in good shape* follow the procedure documented here to bring 
up the micronode. This procedure is not complicated; howevert 
it does not always work the first time* If recovery fails* 
simply try again* If* after trying several times* you still do 
not succeed* see section 3*4 below* F.rrors and Recoveries* 

Once the micronode is up* if your System XXV is connected to 
TYMNET* you need to make sure TYMNET and the micronode are 
communicating with each other and that TYMNET is OK* The second 
to last step in this procedure will allow you to do this. Skip 
it if it does not apply to you. 

3*2 Summary 

1) Cone-terminal installations} Put the switch on the side of 
the operator*s terminal to the position marked "Foonly" 
(usua I ly up) • 

2) On the system terminal* type a few carriage returns* You 
should see the prompt "8" or "!". If you get "8"* type 
"ena<CR>"; you should then get "!". 

3) On the system terminal* type »<CTRL-E>t ymnet <SP>of f <CR>" • 

4) Cone-terminal installations} Put the switch on the side of 
the operator's terminal to the position marked "micronode" 
(usually down). 

5) Check the micronode's power light* the right light on the 
front. If the light is lit* the power is on* If the light 
is off* turn on the power switch on the back of the 

mi cronode • 



6) Put off (down) the three switches 
mi cronode • 



on the front of the 



7) Put on (up) LTC* the switch on the right. 

8) Put on (up) HALT* the switch on the left. 

9) Put on (up) INIT* the middle switch. The RUN light (the left 
light on the front of the micronode) should light. 
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10) Type a few carriage returns on the mlcronode terminal* 
you see a "$"* the prompt for the micronode*s Command 
Processor* type "DQ<CR>" (0 here Is a zero)* 



Uhen 



11) C one-terminal Installations!! Put the switch on the side of 
the operator's terminal to the position marked "Foonly". 



12) On the system terminal* type a few carriage returns, 
you get the prompt "!"* type 
"run<SP><system>nodebo<ESC><CR>". 



Uhen 



13) Uhen you see "MICROCODE IMAGE FILENAME >"* type "<ESCXCR>". 

14) The System XXV will report that it is trying to reset* load* 
and start the mlcronode. If this process 1s successful* you 
will get the message "NODE BOOTSTRAP COMPLETED SUCCESSFULLY" 
followed by some system messages. 

15) When you get the M !" prompt on the system terminal* type 
"<CTRL-E>tymnet<SP>on<CR>" . You may get some more system 
messages. After a few minutes* you should see your last 
message* "TYMBASE UP". 

16) If you do not get "TYMBASE UP" or you get the message "MUST 
REPEAT ENTIRE REBOOT PROCEDURE"* something has gone wrong. 
Turn the micronode's power off and back on and begin again 
with step 1. 

17) Cone-terminal installations!] Put the switch on the side of 
the operator's terminal to the position marked "micronode". 

18) Type a few carriage returns on the micronode terminal. If 
you then see "Please log in: H * the micronode is OK. If you 
are NOT asked to log 1n* the micronode has come up wrong* 
start recovery again from step 1. 

19) Tfor systems on TYMNET} Uhen you see "Please log in:"* wait 
a few minutes and then try to log 1n to another host on 
TYMNET. If you succeed* TYMNET 1s OK; log out from the other 
host. If you do not succeed* try again. If you have not 
succeded after five minutes* something may be wrong with 
TYMNET. Call the TYMNET Network Control Center and report 
the problem. 

20) Cone-terminal Inst al I at 1 ons 3 Put the switch on the side of 
the operator's terminal to the position marked "Foonly". 
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reloaded from the System XXV where 1t Is permanently stored. 
The micronode recovery procedure first prepares the micronode to 
receive this program and then Instructs the System XXV to send 
It over, Once the program has been successfully transmitted and 
the micronode 1s running 1t* the System XXV must resynchronl ze 
with the micronode so they can pass Information back and forth. 
If the System XXV succeeds 1n synchronizing with the micronode* 
then the micronode has probably come up correctly* 
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You now prepare the System XXV and the micronode for recovery. 
Since you do not want the System XXV to use the micronode as you 
bring 1t up* you begin by typing M <CTRL-E>tymnet < SP>of f <CR>" on 
the system terminal. This tells the System XXV that the 
micronode 1s no longer available. Next* If you are at an 
Installation with one operator's terminal* connect the terminal 
to the micronode Instead of the System XXV by putting the switch 
on the operator's terminal to the position marked "micronode" 
(usually down). Now you need to check the micronode Itself to 
make sure 1t has power. The right light on the front of the 
micronode 1s lit when the power 1s on. If this light Is off* 
turn on the power switch at the back of the micronode. Finally* 
to reset the micronode before bringing 1t up* put off (down) the 
three switches on the front of the micronode. 

You now are ready to begin bringing up the micronode. You do 
this by putting on tup) the three switches on the front of the 
micronode. Make sure that you out on these switches In the 
proper order; putting them on 1n the wrong order* can cause 
serious damage. First* put on the right switch on the micronode 
labeled "LTC". This switch turns on the line clock timer* an 
internal timer that makes sure computer procedures happen at the 
correct Intervals and are synchronized. Second* put on the left 
switch on the micronode labeled "HALT". Third* put on the 
middle switch on the micronode labeled "I NIT". 
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The System XXV will now deliver the micronode image file to the 
micronode and bring it up. As it does this* the system will 
print various messages about its progress* such as* "resetting 
the micronode"* "loading the micronode"* or "starting the 
micronode"* If and when this process is finished* you will be 
told "NODE BOOTSTRAP COMPLETED SUCCESSFULLY". 

Once System XXV has successfully finished bringing up the 
micronode can communicate with it* on the system terminal type 
"<CTRL-E>tymnet<SP>on<CR>". This tells the System XXV to try to 
synchronize with the micronode and attempt to send and receive 
information* If 1t sucedes* you will see some more system 
messages and, after a while* "TYMBASE UP". If* after waiting 
several minutes* you do not get this message or* if you get the 
message "MUST REPEAT ENTIRE REBOOT PROCEDURE"* something was 
wrong with the micronode*s recovery. Either the image file was 
not delivered sucessfully or the System XXV could not 
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3.4 Errors and Recoveries 

"Must Repeat Entire Reboot Procedure" 

If you get this error message* repeat the entire procedure. 
Repeated Failure to Bring up the Micronode 

Int roduct ion 

If* if after trying several times* you cannot bring up the 
micronode* this may mean that the micronode Itself has a 
memory problem. To determine if this is the case* you run 
a short program that checks the memory of the micronode. 



Summary 
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1) Repeat steps 1 though 9 of the recovery procedure. 

2) At step 10« where you would normally type "D0<CR>% 
instead type M XM<CR> n . Note that all commands to the 
mlcronode must be capitalized. 

3) Cone-terminal inst al lat ions 1 Put the switch on the 
side of the operator's terminal to the position marked 
Toon I y". 



4) The mlcronode will now examine its memory* If it 
prints a series of numbers on the micronode terminal* 
there is something wrong with the memory. Call 
Tymshare Maintenance. 

5) If nothing is printed* the memory is good but you may 
stHl have a hardware problem. Try the entire recovery 
procedure from step 1 twice more. If you do not 
succeed* notify Tymshare Maintenance. 



* " . * 

* MICRO-NODE NETWORK MANAGER'S GUIDE * 

¥ January 23/ 19«1 * 

* * 

* TXMSHARE Distributed systems Group * 

* Cupertino, Ca. * 

*?*;|^¥**^**:M**¥**********¥********** ********* 



ittr,^ 



'SSi 



Table of Contents 



Table of Contents 



section 



Page 



1. Introduction ......... 1 

2. Node configuration 2 

3. Routing configuration 11 

4. Node modules •••• •••• 12 

5. Module assembly • • . 15 

6. R5TS host configuration 17 

Appendix A 

DEC 9301 Bootstrap Module ........... 20 

AppendixB 

DEC BDVll bootstrap module 24 

Appendix C 

Memory allocation 25 

Index ••••••••••••• 27 



TYMSHARE Distributed Systems Group, Cupertino, Ca. 



MICRO-NODE NETWORK MANAGER'S GUIDE 



TYMSHARE Distributed Systems Group, Cupertino, Ca. 



Introduction 



1 Introduction 

Tnis manual provides tne specified information needed oy tne manager 
of a MlCRQ-NODfe: network. Topics coverea incluae general rules" for 
configuring a networK and detailed information on specifying software 
and hardware configurations of network nodes. 
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2 Node configuration 

The configuration of each node in a MICRO-NODE network must be 
specified in a configuration file for that noae. in adaition, tne 
global configuration of tne entire network must be specified in a map 
file for the network. Also, a link command file must be produced tor 
eacn node. To generate tne program for each node, the module COMMON. MAC 
is assembled with the configuration file and the module ROUTE. MAC is 
assembled with the configuration and map files. 

The resulting object files are linkea along with the pre-assembled 
node object files which are independent of the configuration using the 
linker program to produce'a "image" file which can be loaded from a host 
into the node using the NODLOD program. The image file can be input to 
tne program nibtrn to produce a "NIB" format file for loading over 

T/MNET using LOADU.- 

A GENBAS program is planned to generate the required configuration 
and command files for building a network" node. Until this program is 
available, the configuration and command files must be edited manually 
to indicate the desired configuration,' 

Following Is a complete typical node configuration file: 

* ' " » 

* .SBTTL TEST - NEXILIS/JRG * 

* .SbTTL TEST - CONFIGURATION FILE FOR NUDE NEX01 * 

* " * 

* .MACRO CONFIG * 

* . . * 
*;DEFIN£ GENERAL PARAMETERS * 

* * 

* DEFINE JIFSEC,60. ;60 TICKS PER SECOND * 

* * 
*;DEFINE THE NAME OF THIS NODE * 

* * 

* NAME NEX01 * 

*;DEFINE LINKS BETWEEN THIS NODE AND OTHER NODES AND HOSTS * 

* * 

* LINK NEXA ,000,TF,1U.,S,D,<170000,120,5> * 

* LINK NEXU2 , 000 ,TF, 10 . , P , C, <17001 , 130 , 5> * 

* * 

♦/DEFINE ALL DEVICES ON THIS NODE * 

* * 

* DEV ST,200,<300,377> * 

* SOC 1. * ' 

* SOC 2. * 

* soc a. . * 

* DEV LP * 

* SOC l.,A,<177554,204,177bb0> * 
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*;DEFINE THE HOST CONNECT LISTS * 

* * 

* HCL A,<NEXA> * 

* * 
*;DEFINE THE DEFAULT HOST * 

* * 

* DHQST NEXA * 

* * 
*;DEFINE TERMINAL LINES * 

¥ * 

* LINX A,<177560,60> * 

* LINE l.,F,3QO, ,NEX,CRT,ASC,RSTS,N,N,Y,Y,HW,A,200 * 

* * 

* LINX B,<160130,340> * 

* LINE 2., A, 3, ,NEX,CRT,ASC,PSTS,N,N,Y,Y,HW,A,2O0 * 

* LINE J., A, 3, ,NEX,CRT,ASC,RSTS,N,N,X,Y,HW, A, 200 * 

* LINE 4., A, 3, ,NEX,CRT,ASC,RST5,N,N,Y,Y,HW,A,200 * 

* LINE 5., A, 3, ,NEX,CRT,ASC,R5TS,N,N,Y,*,HW,A,200 * 

* ' * 

* ,ENDM * 

***************************************************************** 



Following is a description of each macro used in the configuration 
file: 

********** 

* DEFINE * 
********** 

The DEFINE macro is used to assign non-standard values to node 
parameters* It normally does not need to be used, its format is: 

define parameter,value 

dnere: parameter « name of node parameter to be defined 
value = value for parameter 

********** 

* NAME * 
********** 



The NAME macro is used to specify the name of tne node. It must be 
included In tne configuration file, 

NAME node 
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where: node = name of tnis node 

********** 

* TYMSAT * 
********** 



This macro specifies that this node is a Tymsat only node. It has no 
parameters. 

********** 

* LINK * < 

********** 

The LINK macro is used to specify links between this node and other 
nodes or hosts or gateways, 

LluK name, level, aux cap, conn, prisec, type, <xxxxxx> 

where: name = name of node, host, or gateway on other ena of link 

level = minimum priviledge which allowes connection if host or 
gateway; maximum priviledge allowed across link if linlc 
to another node 
auxcap = sets link capabilities as follows: 

TF a connections to and from this link are allowed 
X a connections allowed only to this link 
F a connections allowed only from this link 
N -a no connections allowed to or from this link 
connno - number of connection sockets allocated for this link 
prisec 3 indicates if this end of ' the link is primary or 

secondary (in terms of socket allocation) 
type -a indicates type^of link as follows: 
* A = not. used * 

B = NSP/a (synchronous line protocol) (one end of 
each" link must be primary; the other end must be 
secondary) 
C = DRVli/DRll-C parallel interface link (one end of 
each link must' be primary; tne other end must be 
secondary) 
D s DRVll/DRll-C RSX or RSTS host interface (must 

always be secondary) 
E s x.25 gateway (byte framing) (primary = DCE, 

secondary *■ DTE) 
F =■■ Tymcom-X (2020 and F3) and TENEX host interface 

(must always be' secondary) 
G a Tymnet extended X.25 gateway (primary 3 DCE, 

secondary =■ DTE) 
H » Tymnet" native mode (T201) gateway (must always be 
secondary) 
xxxxxx s specifies link type dependent parameters. 

For types 8, C, and D, the format is: 
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<reg,vec,level> 



wnere: 



reg 
vec 
level 



address of 
address of 
interrupt 
Interface 



first device register 
first device vector 

priority level for 



For lin< types E and G the format is: 

<r eg, vec, le ve i,dst, ad st, window, ti,ni,n2> 



where: 



reg 
vec 
level 

dst 

adst 

window 
Tl 

Nl 
N2 



addr 
addr 
Inte 
inte 
dest 
conn 
alte 
inco 
f ram 
no r 
max! 
info 
max! 



ess of 
ess of 

rrupt 

rface 

ination 

ections 

mate 



first device 

first device 

priority 



register 
vector 
level for 



name 



for 



name 



incoming 
for 



destination 
mlng connections 
e level window size 
esponse timer value (ticxs) 
mum number of" bytes in frame 
rmation field 
mum number of retransmissions 



Format for type F link is: 

<r eg, vec, level ,rngsiz,KMC> 
wnere: 



reg « address of first device register 
vec - address of first device vector 
level « interrupt priority level for 

Interface 
rngsiz - size of host input ring (in PDP-10 

words) 
KMC indicates that a KMC is used in 

the 2020 interface 



Format for type H lin)c is: 

<nodnum,nspn,Kind> 



where: 
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kind , s kind of link - must be one of the 
following: 

SAT = TYMsat 

BAS = TYMbase without terminal protocol 
conversion 

TPC = TYMbase with terminal protocol 
conversion 



********** 

* LNKH * 
********** 



The LNKH macro is used follow a LINK macro tor a type H gateway to 
specify the "hosts" which are to be known to Tymnet, If this node is 
not to support any hosts, i.e., if it is to be a "TYMSAT" only node, 
this macro should not appear. In this case the lkhst modules must be 
loaded. If it does appear, this node will be a "TYMBAS" and the LKHBS 
modules must be loaded. The format is: 
LNKH TYMHST, NEXHST 

wnere: TYMHST = Tymnet host number 

NEXHST « MICRO-NODE host name which corresponds to TYMHST 

There may be up to 4 hosts specified for each type H link. 

********** ;j - * 

* LNKL * 
********** 



The LNKL macro is only used following a- LINK macro for a type H 
qateway. it specifies a synchronous line connecting to Tymnet. The 
format is: 

LNKL chn,nbr, speed, sat, type, xxxxxx 

wnere: chn = Number of channels on line (number of groups times 16) 
nbr = number of neighbor node 
speed a- speed of line as follows: 

1= 2400 baud 

2 s 4800 baud 

3 s 56000 baud 

4 s 9600 baud 
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sat 

i ■ 

l 

type 
xxxxxx 



S if this is a satellite linx with long propigation 
delay/ N if it is a normal linK 
line driver type - currently roust always 
line driver type dependent parameters" as 
<reg, vec,level> 
where: reg = address of 
vec = address of 

level = interrupt priority level for 
interface 



be A 
follows : 



first device register 
first device vector 
priority level 



A type H linK must always specify at least 1 Tymnet line using a LNKL 
macro. Up to 8 lines maybe specified. Ail LNKL macros must follow all 
LNKH macros. 

********** 

* DEV * 
********** 

Tne D£V macro specifies all non-terminal devices on tne node. It is 
only needed if devices are present. Its format Is: 



DEV 



dv, level , <xxxxxx> 



where: dv » two letter mnemonic for device 

level = minimum priviledge level for connection to device 
xxxxxx s device dependent parameters 

valid devices are: 



ST 



Status device- - this is a. software device which is used to 
obtain status Information from the node and to control the node. 
The" status device is'optional but should usually be included to 
allow access to data stored in the node. The two device 
dependent parameters* are the priviledge level for examining and 
writing memory. ' 



wo 



Load device - this is a special device which is used to down- 
line load adjacent nodes. It only be used with type B or C 
linXs. " when included, it must always be specified with one 
socKet. 



LP 



Line printer 



********** 

* 30C * 
********** 
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The SOC macro is used with the DEV macro to specify devices. Each 
DEV macro must be followed by one or more sue macros which specify each 
socket on tne 

device as follows: 

SOC sn,type,<xxxxxx> 

Where: sn » socket number (must start at 1 and increase by 1) 

type .» type of device driver for this socket (not used for ST 
or WD) 

xxxxxx » device driver dependent parameters (not used for ST or 
WD - LP has unknown device dependent parameters) 

********** 

* HCL * 
********** 

The HCL macro specifies any "host connect lists" wnich are to be used 
oy terminals' on this node,. 'Each host connect list specifies an ordered 
list of host systems which is used when a terminal is initially 
connected to the node or when a "connect" command is issued without an 
argument. Format of this macro" is: 

HCL list,<hostl,host2, . . .> 

where: list * a single letter which identifies this list. First list 

must, be "A", second "8", etc. 

hostl - name of first host system in list 

nost2 = name of second host system in list 



********** 

* DHOST * 
********** 



The DHOST macro specifies a single "default host" whicn will be used 
as the destination whenever* an unknown host is specified. The host 
specified will be used as the destination extension. This allows hosts 
connected to a foreign network connected to this network through a 
gateway to be accessed in a transparent manner. The gateway is 
specified as the default host. Anyreguests for an unknown host will 
tnus be routed to the gateway, which will then use the destination 
extension as the destination on the foreign network. Format of' this 
macro is: 
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dhqst nstnam 
where: nstnam = name of default host (or gateway) 



* LINX * 
********** 



The LINX macro specifies the asynchronous terminal interfaces 
node. Format" is: " «' "■ 



on the 



LINX 



type,<xxxxxx> 



Where: type = type of interface as follows: 

A s OLVli/DLil single line" interface 
a sr DZVli/DZil 4 or a line interface 
C - DHli"l6 line interface 
o a Infotron 780 "super-mux" driver 
F s Nexilis Systems DCP board 
xxxxxx = interface dependent parameters 

(usually <address, vector , prior ity>) 



********** 

* LINE * 
********** 



Each line on each terminal interface must be specified in a LINE 
macro. The LINE macros must immediately follow the LINX macro which 
specifies the interface* Its format is: 

LINE num,fa,or ,ir, cmd, type, code, pro, ask,snm, cm, acd, rob, dun w,hcl,priv 



where : 



nam 


s 


socket 


fa 


s 


indica 
line; 






high 
printe 
are us 
lines 
may be 


or 


s ' 


output 
fa a A 


ir 


2 


Input 
output 


cmd 


— 


name o 
TYMNET 


type 


= 


defaul 


code 


= 


defaul 



number for port (must be in as 
tes if fixed or auto-baud ra 
F » fixed, A s auto, C « spe 
speed clock, L = special lin 
r port. If C or F, no paramete 
ed. All C or L lines must f 
(even 11 on different interface 
"freely intermixed as may c or 

baud rate if fa = F or' auto ra 

baud rate if fa s f and it is d 
rate - otherwise should be nul 

f network command decoder - sho 
base and "SAT" for a TYMSAT 

t terminal type (usually "TYMSH 

t character code "for " terminal - 



cending order) 
te or If special 
cial line used as 
e used as serial 
rs beyond this one 
ollow all A or F 
s). F and A lines 
L lines, 
te detect type if 

* 
ifferent from the 
1 
uld be "TYM" for a 

R" ) 
valid values are 
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ASC (Ascii), CRS Cselectric correspondence) f CAL 

.(Selectric Cail-360), BCD cselectric BCD), and EBC 

Cselectric EBCD) 
pro = default" terminal profile (based on host; TYMSHR, rsts, 

RSX) 
ask = Y if should ask for Tymshare terminal ID; N if should 

not 
snm s y if should suppress all network messages, I if should 

suppress only informational network nessages, N if 

should output all network messages 
cm ^ Y if should allow network command mode and command mode 

should be default when not connected? R if should allow 

network command mode but only as a result of typing the 

command interrupt character; N if network command mode 

is not allowed 
acd » Y if should do auto-connect when a disconnect is 

received; N if should not (not used with TYMNET 

version) 
rob s Y If should release (hang up) tne terminal when a break 

is detected, N if should not 
dunw s indicates if dial-upCanswers ring indicator and watches 

carrier detect) or hard-wired line; du = dial-up, HW - 

hard-wired 
hcl =■ host connect list - single letter which must nave been 

used as a host connect list name in a HCL macro 
priv *• network privilege for terminal (a octal number in the 

range 0-377) 
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Routing configuration 



For all configurations of micro-nodes some routing information is 
necessary. For an * isolated node tne routing is simple and 
straightforward. As the the number of nodes in a network increases, the 
routing become more complicated. The routing information is contained 
in tne ROUTE macro. Generally the ROUTE macro is placed in a fiie of 
the form RUxxxx.MAC, where xxxx is the node number. The ROUTE macro has 
three parts: node identification information, local resource 
information, and connectivity information for ail other resources in the 
network. 

An example of a routing macro is: 

; ru552.mac - network map for node 552 (and friends) 
.macro ROUTE 

node 552 

NPATH 554,554 
NPATH 553,553 
hpath 119,554,553 

HPATH 930, * 
hpath TYMNET,* 
HPATH BNET,554 
NODE 553 

NPATH 552, 5$2 
NPATH 554,552 
HPATH 113,*, 552 
HPATH TYMNET, 552 
HPATH 930,552 
HPATH BN£T,552 * 

NODE 554 

NPATH 553,552 

NPATH 552,552 
HPATH, 930,552 
HPATH 118,*, 552 
HPATH TYMNET, 552 
HPATH BNET,* 
.endm 

The NODE statement specifies which node the Information that follows 
is associated with. Information which follows a NODE sStatement for a 
node otner that the one being assembled is ignored. Thus a NODE 
statement is REQUIRED in order for routing information to be assembled 
for a node.. . 

The first NPATH parameter specifies the primary path tor reaching 
other nodes in the network. The second parameter specifies a secondary 
path to be used if the first is down. 

The HPATH statement specifies how to reach resources (hosts and 
gateways) in the network. The "*" indicates that the resource "is in the 
node being assembled. It specifies a primary and a secondary path line 
the rtPATH statement. 
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4 Node modules 

The following table summarizes the modules required for various node 
configuration options, " Each module should only be loaded once and all 
modules may be loaded in any order after the common, route, and XDT 
modules except that END must always be the last module loaded. 

The base for the loaded image should normally be 1000, This is the 
default for the PDP-11 LINKll iinker. It must be specified for the PDP- 
10 cross-linker. If the node uses an mxv-U multi-function card with 
tne ROM area configured for bank 0," the base address must be 21000, 
This must be specified for both' the PDP-11 linker and the PDP-10 cross- 
linker. 

The following modules must always be loaded: 

CGXXXx,RUxXxX, EXEC , ERROR ,PKT1 ,PKT2 , PKT3D, ONCE, END 

If the node Includes a Tymshare "watch-dog" timer, the DUG module 
must be Included unless the AUTQ7 module is Included, 
Tnis table shows modules required for each type of link. 

Type Notes Modules required 

B using DUPI1 LNK1 ,LNK2,LNKFLG,LNKB,LNKBS,LKBDUP 

B using DUV11 LNK1,LNK2,LNKFLG,LNKB,LNKBS,LKBDUV,CRCBYT 

B using DCP . LNK1,LNK2,LNKFLG,LNKB,INK6S,LKBDCP 

C LNK1,LNK2,LNKRSP,LNKC 

D LNKl,LNK2,LNKRSP,LNKD 

LNK1,LNK2,LNKE,LKEPKT,X2 5U,CRCTAB 

LNK1,LNK2,LNKF,LNKF2,TYMA,TYMB 

LNK1,LNK2,LNKF,LNKF1,TYMA,TYMB 

LNK1,LNK2,LNKG,LKGPKT,LKGQAL,CRCTAB 

LNK1,LNKHA,LKHST1,LKHST2,LKHST3,TYMA 

(see note 1) 

LNK1,LNKHAP,LKHST1,LKHST2,LKHSTS,TYMA 

(see note 1) 

LNK1,LNKHA,LKHBS1,LKHBS2,LKHBS3/TYMA,TYMB 



E 

F using KMC 

F without KMC 



For a Tymsat only node, the following standard-modules must be 
assembled with the parameter file SAT.MAC in addition to XP.'MAC: 
TRM, TRMF, TRMt, TRMP, CMOS. 

note 2: For a node with Tymnet terminal protocol conversion, the module 
TRMP must be assembled with the parameter file TPC.MAC in 
addition to XP.MAC. 
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The following table specifies which modules are required for devices: 



Device Type 
WD 
ST 
LP A 



Modules required 
LOAD 
STATUS 
LPTA 



If any terminal lines are specified for the node, the following 
modules must be included: 



TRM,TRMF,TRMP,TRMT,CMDS 



If any terminal lines specify the "TYM" command decoder, the CMDTYM 
module must be included. 

If any teminai lines specify the "SAT" command decoder, the CMDSAT 
module must be included* 



If any terminal specifies auto-baud, the modules corresponding to the 
auto-baud detect type specified must be included: 

Description 

110, 150, 300 baud ascii 

and 134.5 baud correspondence 
110, 300, 1200 baud ascii and 

134.5 baud correspondence code 
300, 600, 1200, 1800, 2400, 4800 

and 9600 oaud ascii 
TYMNET style detect for 110, 150 

and 300 baud ascii terminals 
TYMNET style detect for 110, 300 

and 1200 baud ascii * 
TYMNET style detect for 110, 300 

and 1200 baud ascii and 134.5 

baud correspondence or ebcdic 

(using high speed clocK) 
TYMNET style detect same as 

type 6 (but with DOGbuiltln) 



Detect" 
l 


type 


Module 
AUT013 


2 




AUT013 


3 




AUT013 


4 




AUT045 


5 




AUT045 


6 




AUTQ6 



AUTQ7 



The AUT06 and AUT07 modules cannot both be loaded in the same node. 
The AUT07 module includes Tymshare watchdog timer functions, so' if it is 
loaded, the module DOG must not be loaded. 



If any terminai^codes other than Ascii are specified, the modules 
specified in the following table must be included: 



Code 



Module 
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CRS XLTCRS 

EBC XLTEBC 

CAL XLTCAL 

BCD XLTBCD- 

Note that some auto-baud detect tables specify codes other than 
ASCII. Use of any of these auto-baud tables also require that the 
corresponding translation tables be loaded. 

Tne following table specifies which modules are required for terminal 
interfaces: 

Type Notes Modules required 
A LINA 

8 no C or L lines LINB 

B C or U lines LIN8X 
C LINC 

D LIND,LIND1 

F LINF 
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5 Module assembly 

The configuration dependent modules are assembled using 
macnu as follows: (node name is assumed to be "xxxx") 



MACRQ-11 or 



CGXXXX=XP,CGXXXX, COMMON 

RUXXXX=XP,CGXXXX,RUXXXX, ROUTE 

If sources are available, the remaining modules are assembled as 
follows; 
For machines with EIS For machines without EIS 



EXEC=XP,EXEC 

£RROR=XP, ERROR 

PKT1=XP,PKT1 

PKT2=XP,PKT2 

0QG=XP,DQG 

3TATUS=XP, STATUS 

rRMsXP,TRM* 

TRMF=XP,TRMF* 

TRMP=XP,TRMP** 

TRMT=Xp,TRMT* 

CMDS=XP,CMDS* 

CMDNEX=XP/CMDNEX 

CMDTYM=XP,CMDTYM 

AUT013=XP,AUT0l3 

AUT045=XP,AUT045 

AUT06=XP,AUT06 

AUT07=XP,AUTQ7 

XLTCRS=XP,XLTCRS 

XLTEBC=XP # XLTEBC 

XLTBCD=XP,XLTBCD 

XLTCAL=XP,XLTCAL 

LINA=XP,LINA~ 

LINB=XP,LINS 

LINBX=XP,LIN3X,LINB 

LINC=XP,LINC 

LIND=XP,XM,LIND 

LIND1=XP,XM,LIND1 

LlNF=XP,LlNF 

LtfKl=XP,LNKl 

LMK2=XP,LNK2 

LNKB=XP,LNK8PR,LNKB 

LNKBS=XP,LNKBPR,LNKBPS 

LKBDUP=XP,LNKBPR,LKBDUP 

bKBDUV=XP,LtfKBPR,LKBDUV 

CRCBYT=XP,CRCBYT 

LNKC=XP,LNKC 

INKD=XP,LNKD 

LNKE=XP,LNKE 

LKEPKT=XP,LKEPKT 

X250=XP,X25Q 

LNKF=XP,LNKFPR,LNKF 



EXEC=NOEIPR,XP,EXEC 

ERROR=NOEI PR, XP, ERROR 

PKT1=NQEIPR,XP,PKT1 

PKT2*NOEIPR,XP,PKT2 

D0G=N0EIPR,XP,D0G 

STATUS=NOEIPR,XP, STATUS 

TRM=NOEIPR,XP,TRK* 

TRMFsNOEIPR,XP,TRMF* 

TRMP=NOEIPR,XP,TRMP»* 

TRMTsXP,TRMT* 

CMDS=NOEIPR,XP,CMDS* 

CMDNEX=NOEIPR,XP,CMDNEX 

CMDTYM*NOEIPR,XP,CMDTYM 

AUTQi3=NO£IPR,XP,AUT013 

AUT045=NQEIPR,XP,AUTU45 

AUT06=XP,AUT06 

AUT07=XP,AUT07 

XLTCRS=XP,XLTCRS 

XLTEBC=XP,XLTEBC 

XLTBCD»XP,XLTBCD 

XLTCAL-XP,XLTCAL 

LINAsNOElPR,XP,LINA 

LINB=N0EIPR,XP,LINB 

LINBX=NOEIPR,XP,LINBX,LINB 

LINC=NOEIPR,XP,LINC 

LIND=N0EIPR,XP,XM,L1ND 

LIND1=N0EIPR,XP,XM,LIND1 

LINF=NOEIPR,XP,LINF 

LNKlsNOEIPR,XP,LNKl 

LNK2aXP,LNK2 

LNKB«NOEIPR,XP,LNKBPR,LNKB 

LNKBS=NOEIPR,XP,LNKBPR,LNKBPS 

LKBDUP=NOEIPR,XP,LNKBPR,LKBDUP 

LKBDUV=NOEIPR,XP,LNKBPR,L*BDUV 

CRCBYT=XP,CRCBYT 

LNKC=NQEIPR,XP,LNKC 

LNKD*NOEIPR,XP,LNKD 

LNKE=NOEIPR,XP,LNKE 

LKEPKT=NOEIPR,XP,LKEPKT 

X25Q=N0EIPR,XP,X25G 

LNKF=NOEIPR,XP,LNKFPR,LNKF 



TYMSHARE Distributed Systems Group, Cupertino, Ca 



15 



MICRO-NODE NETWORK MANAGER'S GUIDE 



LNKF1= 
LNKF2= 
LNKG=X 
LKGPKT 
LKGGAL 
CRCTAB 
LNKHA= 
LNKKAP 
LKHST1 
LKHST2 
LKHST3 
LKHBS1 
LKHBS2 
LKHBS3 
LKHTP1 
LKHTP2 
LKHTP3 
LKHTPC 
LQAD=X 
QNCE=X 
EWD=XP 



XP,L 
XP,L 
P,LN 
=XP, 
= XP, 
=XP, 
XP,L 
=XP, 
= XP, 
=XP, 
=XP, 
=XP, 
=XP, 
=XP, 
=XP, 
=XP, 
=XP, 
=XP, 
P,LO 
P,ON 
,END 



NKFPR, 

NKFPR, 

KG 

LKGPKT 

LKGQAL 

CRCTAB 

NKHA 

DUPPR, 

SATPR, 

SATPR, 

SATPR, 

LNKHPR 

LNKHPR 

LNKHPR 

TPC,LN 

TPC,LN 

TPC,LN 

LNKHPR 

AD 

CE 



LNKF1 
LNKF2 



LNKHA 

LNKHPR,LKHPK1 

LNKHPR, LKHPK2 

LNKHPR, LKHPK3 

,LKHPK1 

,LKHPK2 

,LKHPK3 

KHPR,LKHPK1 

KHPR,LKHPK2 

KHPR,LKHPK3 

, LKHTPC 



LNKF1= 
LNKF2= 
LNKG=N 
LKGPKT 
LKGQAL 
CRCTAB 
LNKHA= 
LNKHAP 
LKHST1 
LKHST2 
LKHST3 
LKHBS1 
LKHBS2 
LKHBS3 
LKHTP1 
LKHTP2 
LKHTP3 
LKHTPC 
LOADsN 
QNCE=N 
END=XP 



NOEIPR,XP, 
NOEIPR,XP, 
OEIPR,XP,L 
=NQEIPR,XP 
=NOEIPR,XP 
=XP, CRCTAB 
NOEIPR,XP, 
=NOEIPR,XP 
=NOEIPR,XP 
=NOEIPR,XP 
=NQEIPR,XP 
sNOEIPR,XP 
=NOEIPR,XP 
=NQEIPR,XP 
=N0EIPR,XP 
=NOEIPR,XP 
=NOEIPR,XP 
=NOEIPR,XP 
QEIPR,XP,L 
OEIPR,XP,0 
,END 



LNKFPR,LNKF1 

LNKFPR,LNKF2 

NKG 

,LKGPKT 

, LKGQAL 



LNKHA 
,DUP,LN 
, SATPR, 
, SATPR, 
, SATPR, 
, LNKHPR 
, LNKHPR 
, LNKHPR 
,TPC,LN 
,TPC,LN 
,TPC,LN 
, LNKHPR 
OAD 
NCE 



KHA 

LNKHPR, LKHPK1 

LNKHPR, LKHPK2 

LNKHPR, LKHPK3 

,LKHPK1 

,LKHPK2 

,LKHPK3 

KHPR,LKHPK1 

KHPR,LKHPK2 

KHPR,LKHPK3 

, LKHTPC 



Notes,: 



If for Tymsat only node, these files 
parameter file SAT in addition to XP. 



must De assembled with the 



** If for Tymsat only node, this file must be assembled with the 
parameter file SAT in addition to XP; if for node with Tymnet 
terminal protocol converter • (LKHTPC loaded) this file must be 
assembled with the parameter file TPC in addition to XP. 
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6 RSTS host configuration 

in order to use a RSTS system as a nost in a MICRO-NODE network, 
several networK related parameters' must oe defined at SYSGEN time. 
These parameters specify how the system is connected to tne network and 
how K.B, numbers are mapped to network terminals or devices. The 
parameters associated with the connection to the network specify how 
many nodes are connected to the host and give the device addresses for 
each interface to a node., Note that, unlike other devices on a RSTS 
system, the device addresses for the network interfaces must be 
specified at SYSGEN time. The correspondence between K.B. numbers and 
network terminals or devices is also specified at SYSGEN time. These 
specifications establish a one-to-one correspondence between a RSTS K.B. 
number and a terminal or device on the network. Tnis serves two 
ourposes: first, it allows an "outgoing connection" to be established 
from the host to the terminal or device by simply "initing" the 
corresponding K.B. oy a program; second, it guarantees that whenever the 
specified device or terminal connects to the host system it will always 
be mapped as the corresponding K.B. number. If the specified K.B. 
number is not available, the connection will be refused. This should 
normally not happen since K.B. numbers which are specified to correspond 
to a special network device or terminal are not used in the general pool 
of network K.B. "s. 

The configuration of each RSTS host in a micro-node network is 
specified in the normal manner for RSTS with the addition of the 
information necessary to specify the connection to the network. An 
extended SYSGEN program will be provided, but, until it is available, 
the following proceedure should be used. The standard DEC SYSGEN 
program should be run to specify the RSTS system configuration except 
for the connection to MICRO-NODE. Any direct terminal connections to 
tne RSTS system are specified at this time. Note that the "multi- 
terminal" and "echo control" features are not supported by this release 
of MICRO-NODE and must not be included in the RSTS configuration. The 
output of the SYSGEN program consists' of two files: SYSGen.MAC and 
SYSGEN. CTL. Both of these files must be edited to include the 
specification of the MICRO-NODE connection. In tne CONFIG. MAC file, the 
following lines must be inserted just before the line which reads 
"; terminal options" 

;l if nexilis network support; else 
;number of interfaces to network nodes 
;vector address for first interface 
;vector address for second interface 
;address of csr for first interface 
;address of csr for second interface 
;number of sockets on first interface 
;number of sockets on second interface 
?number of network terminal ddb's 



NX 


= 


1 


NXN 


= 


n 


NUVEC 


= 


veco 


N1VEC 


= 


vecl 


NOCSR 


= 


csro 


N1CSR 


s 


csri 


NOSOC 


s 


soco 


N1SQC 


s 


socl 


NTH 


= 


m 
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DEFINE "OUTGOING" NETWORK SOCKETS 
FORMAT IS: 

KBM K. 8 • NO,, DEV, CLASS, PRIOR 1TY , TYPE, SUBTYPE , WRN , MAX 

.MACRO OUTNET 

KBh specification for outgoing device 

KBN specification for outgoing device 

.ENDM 

DEFINE NETWORK MAP 
FORMAT IS: 
NODE NAME, PRIMARY INTERFACE, SECONDARY INTERFACE 

.MACRO NETMAP 

NODE nodea,npa,nsa 
NODE nodeb,npb,nsb 
.ENDM 

In the above code, upper case letters indicate text tnat must be 
included exactly as given; lower case letters indicate text tnat will 
vary according to the configuration. Additional (or fewer) lines may be 
required In some places depending on tne configuration. For each 
network interface, each of the symbols NnVEC, NnCSR, arid Nnsoc must" be 
defined, where'n is tne number of the interface. The first interface is 
always numbered 0. Also, a separate KBN line must be included for each 
"outgoing" network device. The parameters in these lines must be 
defined as follows: 

CLASS = 200 

PRIORITY s 

TYPE so 

SUBTYPE a 

WRN a-5 ' ' 

MAX ," -*7 

The DEVICE parameter is the full network name of the device; for a 
terminal this is: 

TRnNODE 

where "n" is the port on the node for the terminal and "node" is the 
name of the node. The K.B. number given must fall with the range of 
network K.B^'s in this configuration. Remember that network K.B.'s are 
assigned above all other K.B. "s in the configuration. 

The network map section must include a "NODE" line for each node in 
tne network, including nodes which are not directly connected to this 
host. The , number following the node name indicates which directly 
connected node will be used to reach the indicated node for outgoing 
connections. This is tne number which is used the NnVEC, NnCSR, and 
NnSOC symbols. If a node is not Included in this table, it will still 
be able to connect to the host, but no outgoing connection from the host 
to that node will be possible. 
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The SYSGEN.CTL file must also be edited to inciuae the required 
network modules. These edits are the same regardless of the 
configuration. Preceeding the line which contains only the text 
"TTDINT/C", a line must be inserted which reads "NXDINT/C" , Preceeding 
tne line which contains only the text "TTDVR", a line must be inserted 
which reads "nxdvr/c m . Preceeding the first line which reads "$R 
LINK.SAV", the following text must be inserted; 

After the aoove changes have been made, the RSTS monitor is built in 
the normal way using SYSBAT. 

SR MACRCUSAV 

NXDVR,NXDVR/C=IN: COMMON, KERNEL, DK: CONFIG, IN: CHECK, NXDEF,NXDVR 

$R MACRO. SAV 

MXDI NT, NXDINT/C=IN? COMMON, KERNEL, DK: CONFIG, IN: CHECK, NXDEF,NXOINT 

Tne files NXDINT.MAC, NXDVR.MAC, AND NXDEF.MAC rcust be present on the 
input device. Also, the versions of common. mac* KERNEL. MAC and TBL.MAC 
provided with MICRO-NODE must be used. 
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Appendix A . 
•DEC 9301 Bootstrap Module 



Nexilis Systems provides a set of PROM chips for the DEC 9301 
bootstrap module which allow a Unibus PDP-11 node to be loaded through 
either a local (DR-il)or remote (DU-ll or DUP-ll) connection or from 
paper tape (for diagnostics). A DEC compatible front-panel emulator Is 
also provided for use with PDP-11/04 and PDP-ll/34 machines equipted 
with the operators panel. A simple memory diagnostic routine is 
included. 

Startup characteristics are determined by setting the appropriate 
switches on the 9301 card during installation. The bootstrap" can be set 
up to expect commands from the console terminal or to boot automatically 
from any one of 9 devices without operator intervention. 

The bootstrap is initiated by the operator when the node is powered 
up or when the "boot" "button (programmers panel) or "init" switch 
(operator's panel) is pressed. 



Console terminal commands 

The console terminal startup option is selected during installation 
by setting the 9301 switches as per table A. The bootstrap then 
displays the contents of R0, R4, Sp, R5 and the *$' prompt, initially 
the registers contain garbage. Wow any of the commands from the console 
command summary can be entered* 

Console command summary 

TT Absolute papertape loader for DEC diagnostics 

DO DRll unit boot (local node) 

Dl DRll unit 1 boot (local node) 

D2 DRll unit 2 boot (local node) 

D3 DRll unit 3 boot (local node) 

UO DUx unit boot (remote node) 

Ul DUx unit 1 boot (remote node) 

U2 DUx unit 2 boot (remote node) 

U3 DUx unit 3 boot (remote node) 

L <address> load address 
E examine location 

D <data> deposit data 
S start program 

•Mote - all commands must be in upper case. 
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After loading the node the bootstrap waits several seconds before 
starting the node. 

The memory diagnostic option is selected with the appropriate switch 
settings from table A. This diagnostic tests only the lower 28K of 
memory. Any error detected will immediately halt the CPU at address 
173742, The bad memory location can then be determined by examining and 
recording the contents of these registers: 

RO » expected data 

R4 » received data 

S? » failing address 

This Kind of error is not solved by skipping the memory diagnostic - 
your computer is sickl Call your DEC representative for assistance. 

*** Warning *** 

Ail normal boots should be done with the memory diagnostic option.. 
Tnis may be skipped but only at the risk of your system's Integrity as 
oad memory can cause any number of mysterious problems. 



TYMSHARE Distributed Systems Group, Cupertino, Ca. 



21 



MICRO-NODE NETWORK MANAGER'S GUIDE 

The NX9301 bootstrap is capable of booting a MICRO-NODE node through 
QRll's, DUli's and DUPU's, These devices must be strapped for the 
standard MICRO-NODE address listed below. 



Device 


unit 


Address 


Vector 


DR11 





767770 


300 


it 


1 


767760 


310 


ii 


2 


767750 


320 


ii 


3 


767740 


330 


OUxll 





760010 


340 


11 


1 


760020 


350 


(1 


2 


760030 


360 


II 


3 


760040 


370 



22 TYMSHARE Distributed Systems Group, Cupertino/ Ca. 



DEC 9301 Bootstrap Module 



TABLE 



Automatic startup optidns Starting Switch settinas 

address 34567890 



Keyboard entry 

with memory diagnostics 773000 xxxxxxxx 

w/o " ,f 773030 xxxxooxx 

dro entry 

with memory diagnostics 773426 oxxxoxoo 

w/o M " 77.3430 oxxxooxx 

DR1 entry 

with memory diagnostics 773436 oxxxoooo 

w/o " " 773440 oxxoxxxx 

0R2 entry 

with memory diagnostics 773446 oxxoxxoo 

w/o " '» 773450 oxxoxoxx 

DR3 entry 

with memory diagnostics 773456 oxxoxooo 

w/o " " 773460 oxxooxxx 

DUxo entry 

with memory diagnostics 773470 oxxoooxx 

w/o H " 773472 oxxoooxo 

DUxi entry 

with memory diagnostics 773500 oxoxxxxx 

w/o " " 773502 oxoxxxxo 

DUx2 entry 

with memory diagnostics 773510 oxoxxoxx 

w/o " " 773512 oxoxxoxo 

DUx3 entry 

with memory diagnostics 773520, oxoxoxxx 

w/o " " 773522 oxoxoxxo 

dl paper tape entVy 

with memory diagnostics 773532 oxoxooxo 

w/o " » 773534 oxoxooox 

x = on 

= Off 

Switch 1 must always be on 

Switch 2 should be on to enable automatic boot on power-up, off 
otherwise 
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Appendix 8 
•DEC BDVll bootstrap module 



Nexilis Systems provides a set of PROM chips for the DEC BDVll 
bootstrap module for the LSI-li which allow a node to be loaded through 
either a local CDRVH) or remote (DUV11) connection or from paper (for 
diagnostics). A simple memory diagnostic routine is Included, 

Since there are no option switches on the BDVll module, the bootstrap 
routine scans ail devices for activity and loads from whichever one 
becomes active.. The bootstrap is entered whenever the node is powered 
up or whenever the reset switch In operated. 

Complete information on the operation of the BDVll bootstrap will be 
provided in a later edition of the document. 



24 TY.MSHARE Distributed Systems Group, Cupertino, Ca. 



Memory allocation 



Appendix C 
Memory allocation 



The following specifies all reserved PDP-11 memory locations. Tnis 
includes the recommended device register and vector addresses for 
network. devices and interfaces. Generally, only those devices which are 
to be used for booting must be at the specified addresses since all 
devices are specified in the config file for each node. It is strongly 
recommended that the addresses given here be used, however, to eliminate 
the possibilty" of conflicts. 



The following specify single words: 



0/ 
2/ 



Not used 
Not used. 



The following specify word pairs which contain the 
first word and the new psw in the second word. 



new PC in the 



4/ 

10/ 

14/ 

20/ 

24/ 

30/ 

34/ 

40-54 

60/ 

64/ > 

70/ 

74/ 

100/ . 

114/ 

120/ 

124/ 

130/ 

134/ 

140/ 

200/ 

204/ 

210/ 
214/ 
220/ 
224/ 
230/ 
234/ 
240/ 



Bus time out trap 
Illegal instr trap 
BPT instr trap 
IOT instr trap 
Power fail trap 
EMT instr trap 
TRAP instr trap 
Reserved to software 
CTY input Interrupt 
CTY output interrupt 



LSi-li clock interrupt 
Memory parity 

First DRil input Interrupt 
First DRil output interupt 
Second DRil input interrupt 
Second DRil output Interrupt 
Third DRU input interrupt 
LP/H/TI810 printer interrupt 

RF11/RS1I RJS04/RWS04/RS04 RJS0 3/RWS03/RS03 



disk 



interrupt 
RCll disjc 
TC11/TU56 
RK11/RK05 
TMA11/TU10 



interrupt 
DECtape interrupt 
disk interrupt 
TS03 TJU16/TWU16/TU16 



tape Interrupt 



CRll/CDll card reader interrupt 



PIRQ interrupt 
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244/ FIS trap 

250/ Memory management trap 

254/ RP11/RPQ3 RJP04/RWP04/RP04 disk interrupt 

260/ TAU cassette interrupt 

264/ First rxvii interrupt 

270/ Second RXVil interrupt 

274/ 

300-364 Asynchronous line interfaces or aadltionai link or nost 
interface Interrupts (asynchronous Interface vectors are 
assigned downwards from 364) 

The following specify single words: 

770200-770366 Processor dependent locations 
770370-772036 

772040-772072 RJS04/RWS04/RS04 RJS03/RWS03/RS03 disk 
772074-772436 

772440-772476 TJU16/TWU16/TU16 tape 
772500-772516 

772520-772532 TMA1 1/TU10/TSQ3 tape 
772534-772776 

773000-773376 3DVI1 first window or REV11 first half 

773400-773776 BDVil second window or REVil second half 
774000-776676 

776700-776752 RP11/RP03 RJP04/RWP04/RP04 diSK 
776754-777156 

777160-777166 CR11/CDH card reader 

777170/ - First RXVil disk RXCS 

777172/ First RXVil disk RXDB 

777174/ Second RXVil disk RXCS 

777176/ Second RXYU disk RXDB 
777200-777336 

777340-777350 TC11/TU56 DECtape 

777400-777416 RK11/RK05 disk 

777460-777476 RFll/RSll disk 

777500/ TAU cassette status 

777502/ TA11 cassette data 
777504-777506 

777510/ TI810 printer control control 

777512/ 'Mot used 

. 777514/ LP11/TI810 printer status 

777516/ LP11/TI810 printer data 

777520/ BDVil base registers 

777522/ BDVil scratchpad 

777524/ BDVil switches' 
777526-777544 

777546/ KWll-L clock status 
777550-777556 

777560/ CTY RCSR 

777562/ CTY RBUF 

777564/ CTY XCSR 

777566/ CTY XBtlF 

777570-777776 Processor dependent locations 
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Where applicable and helpful* each large section of this manual 
is divided into four parts: 

Introduction. A quick look at the current section. This 
will tell you such things as what the section is about* how 
the information 1s organized* and where to go if it is not 
what you need. 

Summary. fin outline that briefly presents exactly what you 
need to know or do. This is meant to be used as a working 
document or for quick reference? no explanation is included. 



Discussion. A detailed explanation of 
procedures outlined in the Summary. 



the information and 
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Errors and Recoveries. A List of common problems and 
suggested solutions* 

1*3 Conventions of the Manual 

This manual has a set of conventions that will make itt we hope* 
clear and easy to read* 

Program name?; always appear in capital letters* for example* 
CHECKOISK. 

Special keys on the terminal are indicated by the abbreviat ions? 

<SP> for space 

<CR> for carriage return 

<ESC> for altmode or escape 

<LF> for line feed 

Control characters are indicated with the notation "CTRL" and 
surrounded by angle brackets* for example* <CTRL-X>. To type a 
control character* hold down the CTRL key while typing the 
letter* To type <CTRL-X>» for instance* you would hold down the 
control key and at the same time type an X (in uopercase or 
lowercase)* 

The manual will refer to switches on the control panel by 
function in capital letters* When you look at the control 
panel* you will see that the switches are in rows and that 
different rows of switches are labeled by what they control? for 
example* there is a row of switches labeled "micro processor". 
Inside these rows of switches* individual switches are named by 
what they do* for instance* in the row of switches labeled 
"micro processor"* there is a switch named "stop"* This switch* 
which is used to stop the microprocessor* is called MICRO 
PROCESSOR STOP. 

You put control panel switches "on" by pushing them up* and you 
put them "off" by pushing them down* Some switches are 
momentary, which means that after you put them on (up>* they 
will return to the off (down) position when you release them* 
If you read "Put MICRO PROCESSOR STOP on"* this means push up 
the switch labeled "stop" in the row of switches labeled "micro 
processor" • 

Commands appear in two ways* When the command is discussed in 
the text, the first letter of the command is capitalized and 
there are no quotation marks. When* on the other hand* you are 
directed to enter a specific command* for example in the Summary 
of a section, the command and its arcument(s) are lowercase and 
enclosed in quotation marks. In this case* type exactly what 
you see* excluding* of course* the quotation marks. If the 
operators terminal is uppercase only* you may type the commands 



Int reduction 



Page 3 



in uppercase* however* the reverse 1s not true. All uppercase 
commands must be given that way* do not type them lowercase* 
Some prgrams cannot recognize uppercase letters* 
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2 ERROR CONDITIONS — HOW TO IDENTIFY THEM 

2.1 Introduction 

When you are faced with a system experiencing some problem* the 
first thing you need to do is determine what this problem, may 
be. There are three important aids in this process: error 
messages* BUGHLT numbers* and error lights. Always read and 
record the error messages* BUGHLT numbers* and error lights 
before you attempt to bring the system, up. 

2.2 Zrror Messages and BUGHLT Numbers 

When the system crashes* it usually provides an error message on 
the operators terminal specifying what caused the crash. This 
is followed by a BUGHLT number. Always read and record error, 
messages and PUGHLT numbers when you have a system that is down. 
A list of the various BUGHLT numbers and what they mean comes 
with this manaul. 

The system may be set so that it does not print the BUGHLT 
number* but only prints the word "BUGHLT" followed by the 
location of the BUGHLT. When this happens* type *.C" to force 
the system to print the number. The BUGHLT number will be the 
second* or right* half of the number printed. 

2.3 Error Lights 

When the system is functioning normally* certain lights on the 
control panel are on* others off. When the system crashes* 
these lights change. Lights that indicate the system is 
functioning correctly are replaced by error lights* lights 
indicating some error has occurred. This section will helD you 
tell the difference between lights lit during normal operation 
and error lights. 

Normal Lights 

When the system is operating normally* a pattern 
consisting of four lights will be cycling among the 
address lights on the control oanel. Unless the system is 
very heavily loaded* these lights should be moving. If 
they do not move for a reasonable oeriod of time* the 
system is probably hung or down. 

Error Lights 

The following lights on the control panel are lit steadily 
only when an error has occurred and the system has crashed 
or will crash. 

MEM PAR ERR light indicates a memory parity error. 
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M I PAR ERR light indicates a microcode parity error. 



PROG HAL T liaht indicates that the computer has 
encountered a halt instruction in AUGUST* the operating 
system* Systems programmers occasionally install halt 
instructions in AUGUST to help them trace problems. 
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3 IS THT SYSTEM HUNG OR HAS IT CRASHED? 

Before you can deal with a system that is not operating correctly* 
you must determine whether it 1s hung or has crashed* Learning to 
recognize a hung system 1s a matter of practice* There Is no one 
sure test that wilt determine 1f a system is hung* but hung systems 
do have the following common symptoms* 

1) Lights on the control panel appear static or are Immobile and 
pulsing in some kind of regular pattern* 

2) There is no response when you type <CTRL-C> or <CTRL-T> on 
the operator's terminal* 

3) You cannot log in from another terminal* 

4) You ere receiving irate calls from users who are unable to do 
anything* 

5) In spite of all this, there is no BUGHLT Indicated on the 
operator's terminal* 



If a system is net functioning and does not have one or more of 
these symptoms* then it has crashed* See section 5» What to do 1f 
the System has Crashed* 
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4 yHAT TO DO IF THE SYSTEM IS HUMS 

4.1 Introduction 

The procedure documented In this section will force a hung 
system to crash. This may seem brutal* but 1t 1s necessary. 
The hung system 1s 1n llano; only after it crashes can you bring 
it back up. When you finish this procedure and the system Is 
down* use the disk recovery procedure to bring 1t up* 

4.2 Summary 

1) Put address switch 31 on (up). 



2) °ut data switch 2 on. 

3) Put CONSOLE" DEPOSIT THIS momentarily on. 

4) Put data switch 2 off. 

5) Put data switch on. 

61 Put CONSOLE DEPOSIT THIS momentarily on. 

7) Walt until activity tthe flickering of the lights* etc.) 
stops. 

8) Bring the system up with the disk recovery procedure. 

4.3 Discussion 

When the system Is hung* it is trapped In the execution of some 
process. The procedure outlined 1n the above Summary is 
designed to bring the system out of this cycle and cause it to 
crash. This is desirable because crashing 1s the normal 
response to abnormal conditions. When it crashes* the system 
tries to take care of itself — to save files* to protect the 
monitor* to print an error message indicating what the problem 
may be* and so forth. Furthermore* only after 1t has crashed 
can the system be brought up. 



Pecause a hung system ignores commands entered 
terminal* to work with one* you must enter the 
manually from the control panel. Put on addres 
pushing the switch up. Then* put on data switc 
momentarily put on CONSOLE DEPOSIT THIS. This 
bit 2 at address 20 octal in the computer's mem 
turn on this bit* you tell the system that ever 
storea 1n the temporary storage area should be 
its permanent location. Temporary storage cont 
information the system has not read out to its 
location and also the intermediate results from 
performed but not yet completed. Before torcin 
crash* you need to make sure that all this 1n1o 
stored in the right place on the disk. 
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Now put data switch 2 off* put on data switch and then put on 
CONSOLE! DEPOSIT THIS. By doing this f you turn on bit at 
address 20 octal. This bit is used by the system to record and 
check its status. When bit is off* the system knows it is 
running successfully? when bit is on* it means the system has 
encountered a dangerous situation and should crash. Thus* when 
you turn on bit manually from the control panel* you trigger i 
system crash. Once all the flickering of the lights stoDS* the 
system is down* Bring it up with the disk recovery procedure* 
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5 WHAT TO DO IF THE SYSTEM HAS CRASHED 

5.1 Introduction 

When a System XXV crashes* before you can bring it ud you must 
decide which recovery procedure to use. T his section will help 
you do this. It is divided Into three parts* The first part 
explains what the System XXV's recovery prodecures do* the 
second part briefly describes the recovery procedures available* 
and the third part will help you decide which procedure you need 
to use* In addition* we give advice about what to do if you 
cannot bring up the system* Once you know which recovery 
orocedure to use* for specific instructions* go to the major 
section describing it* 

5*2 What is a Recovery Procedure* 

T he System XXV is operated by a very large program called the 
"monitor"* The monitor is basically what makes a machine into a 
computer. It 1s responsible for checking the system to make 
sure it is running correctly* transferring information within 
the computer and between it and the outside world* overseeing 
all the various programs run by the users* keeping the users' 
jobs separate and allocating resources to them* and so forth* 

In keeping with Its two functions* running the system and 
overseeing the users* programs and requests* the monitor is 
divided Into two parts* The most Important part is the 
"resident"* or "kernel"* monitor* The two names of this part of 
the monitor reflect its two major characteristics. "Kernel" 
monitor indicates that this part of the monitor is the core of 
the system* It contains basic Instructions and Information 
necessary for the system to function* For this reason* it must 
always remain* or reside* in central memory? thus* the name 
"resident" monitor* 



The second part of the monitor* the "swappable" 


monitor* 


contains Information and procedures related to users' needs 


rather than system functions* It is called the 


"swappable" 


because* unlike the resident monitor* this part 


of the monitor 


is not always present in central memory* Instead Its various 


parts are copied or "swapped" Into central memory only when they 


are needed* The Copy File to File process 1s an 


example of the 


type of procedure located 1n swappable monitor* 


When you enter 


a Copy command* the system begins by looking for 


this process in 


the parts of swappable monitor present in core* 


If it discovers 


that the Copy process is no longer 1m memory* it 


recalls it from 


disk and then executes your command* 





The System XXV's entire monitor is called "AUGUST". AUGUST 
thinks it is running on a PDP10. Since It is not. AUGUST 
depends on another part of the system called the 
"microprocessor". The microprocessor is what translates the 
monitor's instructions into something the System XXV can 
understand. It consists of a memory containing information 
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called "microcode"* and a "mlcrocont ro Her" that uses this 
Information, When AUGUST* the monitor* gives a PDPlO-like 
instruction* the microcontroller takes the instruction and uses 
the microcode to translate it Into the equivalent instruction 
for a System XXV. 

In most System XXV crashes the problem 1s an error in the 
monitor. The System XXV*s various recovery procedures are 
designed to replace the old copy of the monitor with a new one 
from disk or tape where copies are permanently stored. Some 
crashes* however* destroy not only the monitor but also the 
microcode* Since the microprocessor cannot function without the 
microcode* this means that the microprocessor can no longer 
translate the Instructions you or the monitor try to give it. 
In this case* before copying the monitor* the recovery procedure 
must also provide a new copy of the microcode. After the 
microprocessor has this copy of the microcode* the system is 
given the resident monitor. Once the resident monitor Is safely 
stored 1n central memory* the system starts running and then 
copies the swappable monitor. 



After the new monitor 
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you to avoid this syst 



is in memory* in most recovery procedures* 
file system with a program called 
ing is OK* the system reports "August 1n 
s the system is ready to come up and ooen 

If CHECKDISK discovers something wrong 
111 not come un. Instead* it will wait 

problem. After correcting the problem* 
the system and bring it up again* CAs you 

section* some recovery procedures allow 
em checking.) 




you cannot bring it up after trying repeatedly* you may need to 
contact your manager and Tymshare maintenance. 

5.3 Recovery Procedures Available 

Introduct ion 

The System XXV has five recovery procedures. None of them is 
particularly difficult* but they do h3ve substantial 
differences. They are divided into two groups: those 
procedures which return the system to normal use* and those 
procedures which should be used only after \/ery serious 
system error and which do not return the system to normal 
use. The Summary below lists alt five procedures and 
mentions one or two of their most imoortant features. 
Following this is a general discussion of what each procedure 
does and of the procedures 1 relationship to each other. To 
decide which procedure to use after a crash* see the next 
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section* Por details en exactly how each procedure works* 
see the individual section which discusses it. To learn 
about recovery procedures in general* see section 3*2* What 
is a Recovery Procedure. 



Summary 



Each of the following three procedures returns the system to 
normal operation and opens it to users* 

Disk Recovery* You instruct the system to look on the 
disk for the information it needs to come up* 
Mscussed in section 6* 

Tape Recovery* You provide the information the system 

needs to come up from tape* providing a new copy of the 
microcode is an optional part of this procedure* 
discussed in section 8* 

Automatic Recovery* After crashing* the system 

immediately copies the information it needs from disk 
and tries to bring itself up* T his 1s done 
automatically* without waiting for an operator* 
Discussed in section 7* 



Both the next two procedures brings the system up closed to 
normal users and allows systems programmers to investigate 
what is going on* Use them only as a last resort* after 
serious system errors* and under supervision 

Standalone Recovery* You instruct the system to come ud 
without checking the file system or running the system 
5obs* Discussed 1n section 9* 

Disk Rebuild* Before bringing the system up* you wipe out 
and then rebuild the entire file system* reading copies 
of every file from tape* Discussed in section * " 
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Discussion 



When the System XXV crashes* in most cases you bring it ud by 
replacing the old copy of the monitor with a new one* You 
can provide this new copy either by copying 1t from disk? In 
which case you are doing a "disk recovery"* or by reading 1t 
from tape for a "tape recovery". Both of these procedures 
are begun by an operator after the system has crashed. As 
part of the tape recovery procedure you may also read in new 
copy of the microcode the information used by the 
microprocessor* Replacing the microcode is usually necessary 
only after crashes due to power failure* 

In addition to the tape and disk recovery procedures* there 
is another procedure that the system itself can start up 
after a crash* Since the system begins this procedure 
without waiting for anyone to instruct it* this third type of 
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recovery 1s called "automatic recovery", Automatic recovery 
1s very much like disk recovery* Upon crashing* the system 
Immediately copies the current contents of central memory to 
disk* copies in a new monitor from disk* and starts to bring 
Itself up* Automatic recovery never occurs unless the system 
was already set for it before crashing* To learn how to set 
a system to recover automatically* see section 12* Recovery 
Switches. 

Disk* tape* and automatic recovery have substantial 
differences — they are either automatic or not and the new 
monitor comes from either tape or disk* However* all three 
have the same result: they all end with the system checking 
itsetf and the file system and then being opened for normal 
use* The next two recovery procedures do not have this 
convenient result* 

Poth standalone recovery and disk rebuild allow the system to 
skip important parts of the normal recovery procedure. ? or 
this reason they are very risky* do not attempt them without 
being specifically Instructed to do so and without 
supervision of a systems programmer or manager. In 
standalone recovery* the monitor is read from tape and you 
then direct the system to bypass its normal se If -checki ng 
procedures and come up CLOSED to users* This means that only 
the operator»s terminal has access to the system? no other 
users may log in* When a system will accept 1mput only from 
the operator's terminal* 1t is said to be "standalone"* The 
standalone recovery procedures takes its name because it has 
this effect* 

Even more serious than standalone recovery 1s disk rebuild* 
Disk rebuild allows you to do just what you mieht suspect 
from Its name — rebuild the file system stored on the disk* 
As in standalone recovery* you begin by reading 1n a tape 
containing a new monitor* Then* before the system needs to 
use any information from the disk* you begin the disk rebuild 
procedure. A disk rebuild involves destroying all the 
current versions of every file* and returning to the version 
stored on dump tapes? normally* It should NfTVER be used* 

5*4 Deciding Which Recovery Procedure to Use 

Introduct ion 

When a System XXV is down* whether for the first time in a 
month or minutes after a previous crash* the first step in 
bringing it ud is deciding which recovery procedure to use* 
This section will help you make this choice. It is divided 
into t*o parts. The Summary contains a table showing types 
of crashes and their recovery procedures* The Discussion 
e*olains the logic behind the table? it will tell you why a 
particular recovery procedure is used in a certain set of 
circumstances* Once you determine which recovery procedure 
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you need* oo to the section discussing 1t to Learn how to use 
it. 



Sumaary 



The table below shows when to use each of the System XXV f s 
five recovery procedures* The left column lists different 
situations you might encounter; the right column shows the 
recovery procedure you should use* Note that you cannot 
decide to use automatic recovery after the crash has 
occurred. (Automatic recovery means that the system will try 
to bring Itself up after a crash without waiting for an 
operator.) For automatic recovery to occur* the system must 
be set for it before the crash. 



Sltuat 1on 



Recovery Procedure 



Crash NOT DUE to power failure 
Hung system 1s forced to crash 
Any "normal" crash 
After CHECKDISK problems corrected 



Disk Recovery 

Disk Recovery 

Disk Recovery 

Disk Recovery 



Pecovery begins automatically 



Automatic Recovery 



Crash DUE to power failure 
Disk recovery falls 
Automatic recovery fails 

Tape recovery fails repeatedly 



Entire file system destroyed 



Tape Recovery 
Tape Recovery 
Tape Recovery 

Standalone Recovery 
FIRST, contact manager 
or systems programnmer 

Disk Rebuild 

FI^ST* contact ma-ia-ger 

or systems programmmer 
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When a System XXV crashes* the first thing it does is check 
four internal switches* called "recovery switches". Recovery 
switches are four memory locations whose values tell the 
system how to respond to a crash* Recovery switches 
explained in section 125 here it is enough to know that they 
will tell the system to do one of two things: stop and wait 
for an operator* or immediately begin the automatic recovery 
proceoure and try to come up* You should know how the 
recovery switches of each system have been set so you will 
know how it will respond to a crash* If you see a system 
crash and do not know what it will do* watch the system* 
until you know whether it is going to come up automatically 
or you need to begin a recovery procedure* If you see a 
system crash which you know is set for automatic recovery* it 
is wise to keep an eye on it and make sure it really does 
begin the automatic recovery procedure. Recovery switches 
are occasionally destroyed in system crashes* When this 
happens* a system originally set to recover automatically 
will simply sit there waiting* 

If a system does manage to begin an automatic recovery* you 
have at first no decisions to make* If all noes well* the 
system will come back up and you will not need to do 
anything* However* automatic recovery does have two 
pitfalls* First* the recovery may not be successful and the 
system may hang or crash again* If you notice this 
happening* do not let another automatic recovery begin? the 
procedure is hardly likely to succeed on a second try* 
Instead* halt the system* if necessary* and bring it up 
yourself with the backup recovery procedure* tape recovery. 
The second problem that can keep the system from coming all 
the way up is errors in the file system* As the system comes 
up* it uses a program called "CHECKDISK" to examine the disk 
and make sure the files are OK. If CHECKDISK discovers 
problems* the system will stop to wait for someone to correct 
them. After correcting the errors* you will have to halt the 
system* and bring it up with disk recovery* 

If* after a crash* a system does not try to come up 
automatically but instead just sits there waiting* then you 
must take over and begin some recovery procedure* Your 
choices at this point are disk recovery and tape recovery* 
Of these* disk recovery is more convenient and should be 
tried first* simply because it is so easy to use* However* 
disk recovery requires that the procedure itself survive the 
crash and that EDDT be available to begin it* Both of these 
are part of the old monitor* Crashes due to oower failure 
destroy the old monitor (and microcode) completely and thus 
wipe them out. If you think the crash was the result of 
power failure* do not use disk recovery* instead* try tape 
recovery. 

If you do decide to start with disk recovery and the system 
succeeds in running CHECKDISK* this means EDDT and the 
recovery procedure itself are OK. E\ten if CHECKDISK 
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discovers f1te problems and the system does not come uo * you 
may again use disk recovery* after correcting the problems 
and halting the system. File problems do not Indicate that 
anything 1s wrong with the actual recovery procedure. 
However* If the first time you try disk recovery the system 
does not get as far as running CHECKOISK — the recovery 
procedure never starts or the system crashes or hangs — you 
will know that either EDOT or the disk recovery procedure or 
both did not survive the crash* In these circumstances* 1t 
1s a waste of time to try the procedure a second time. 
Instead* halt the system* 1f necessary* and switch to tape 
recovery. 

Tape recovery* the last of the three "normal" recovery 
procedures* 1s the backup procedure. In tape recovery the 
system copies the Information it needs from tape? thus* 
recovery does not depend on any part of the system being able 
to function. Instead you enter all commands to the system 
through the control panel. However* although tape recovery 
is the most reliable of the recovery procedures* it is also 
the most time-consuming and Inconvenient. Do not try taoe 
recovery if you think disk recovery will work. 

If you must use tape recovery* because the power failed or 
disk and automatic recovery do not work* feet free to try it 
several times. If you are using It after a power failure* or 
if nothing happens when you try to read the monitor tape* 
begin the procedure by reading 1n the microcode tape. If 
recovery does start* but the system never reaches the point 
of running CHECKOISK* halt the system* if necessary* and try 
the procedure over* again beginning by reading in the 
microcode tape. If* after trying the recovery three times 
from beginning* the system still does not run CHECKOISK* 
something may be seriously wrong. Notify a systems 
programmer or your manager; they may want to try standalone 
recovery. Once CHECKOISK does run* even if CHECKOISK 
discovers problems with the files system* the new monitor is 
1n memory and this part of the recovery procedure has been a 
success. In addition* since EDDT and the disk recovery 
procedure are part of the monitor* they ars again available. 
If CHECKOISK detects file problems and you must halt the 
system after correcting them* you may use disk recovery to 
bring the system back up. 

Standalone recovery 1s the procedure used when some problem 
with the file system* CHECKOISK* the system jobs* and so 
forth* is causing the system to crash after the monitor 1s 
read into memory* but before it can come up all the way and 
return to normal use. In standalone recovery* after the 
monitor is cooled from tape* the system simply stoos where it 
is and waits. A systems programmer can then examine the 
monitor* the file system* and so forth* and try to determine 
what is wrong. A standalone recovery is not hard to do* but 
since the system comes up without checking how it 1s 
operating or making sure the tile system is good* great harm 
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may be done by mistake. Never undertake standalone recovery 
without expert supervision* 



The final 
used only 
crash has 
Disk rebul 
that befor 
system 1s 
files can 
the most c 
lost. The 
a manager 
will never 



type of recover 


after a systems 


damaged the fit 


Id allows you t 


e anything is n 


replaced with b 


be replaced onl 


urrent versions 


decision to do 


cr a systems pr 


have to be use 



y procedure* 

programmer h 
e system beyo 
o bring up th 
eeded from th 
ackup files f 
y with their 
of many file 
a disk rebui 
oarammer* and 
d. 



disk reb 
as deter 
nd all h 
e system 
e di sk « 
roii tape 
most rec 
s will b 
Id can b 
we hope 



ulld* should be 
mined that a 
ope of repair. 

In such a way 
the entire file 
• Because 
ent backups* 
e permanently 
e made only by 

the procedure 



5.5 Difficulty Bringing Up the System 

If you cannot bring up the system or feel that something 
mysterious is going ont call Tymshare Maintenance or an OflD 
operating systems programmer. 
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DISK RECOVERY 



£•1 Introduction 

You should try to bring t 
procedure after any crash 
procedure 1s quick and ea 
monitor surviving the era 
Qo not try to use disk re 
attempt at bringing up th 
before CHECKDISK Is run* 
and then switch to tape r 
the system^s new monitor 
has been successful* Eve 
file system and you must 
them* you may again use d 
up* To correct problems 
system* see section 13* R 

6*2 Summary 



he System XXV up with the disk recovery 
that 1s not due to power failure* The 
sy» however* 1t relies on part of the 
sh* This means 1t may not always work* 
covery more than ONCE* If your first 
e system with disk recovery falls 
you must halt the system* If necessary* 
ecovery* If CHECKDISK does run* then 
1s In place and this part of recovery 
n 1f CHECKDISK finds problems with the 
halt the system after taking care of 
Isk recovery to bring the system back 
found by CHECKDISK and to halt the 
elated Procedures* 



the operators terminal and look 



1) Check the EUGHLT number on 

1t up In the 11st of BUSHLTs* 1n addition* note which error 
lights are lit* Record all this Information* 



2) On the operator's terminal* type "dskr IdCESOc?"* 



3) The reoonse should be "reloading from disk"* 
get this message* begin a tape recovery* 



If you never 



4) When the system says* "BOOT FROM DISK PACK » CCR FOR ANY}"* 
type <CR>* The system will begin to copy the monitor and 
will record Its progress 1n messages* 

5) When the* operators terminal says "EDDT"* type "start<ESC>g"* 
After a short time* the system should report the size of the 
memory and print several messages about BAT blocks* 

t> CHECKDISK will run and check the file system. If 1t finds no 
major errors* 1t will report the number of disk pages used 
and the number available* If bad files are discovered* they 
will be listed and the system will announce "August not 1n 
operat ion"* 

8) If CHECKDISK runs successfully* the system will announce 
"August 1n operation" and ask for the date and time* Enter 
these 1n the form DD-*-ON-YY<SP>HH:MM » follow with <CR>* The 
system jobs will log In automatically* 

<?** When the system prompts you with "£"* the prompt for EXEC* 
log In by typing "oper<SP>password<SPXCR>"* where password 
stands for your password* 
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10) After the system prints various messages and prompts with 
you another "3"* type "ena<CR>". The response will be a new 
promDt* "!"• 

11) Type "ref <SP>a<CR>". 
6.3 Discussion 
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You begin disk recovery by typing "dskrldCESOg". "Dskrld" 
stands for "disk reload"; 1t Is the name of a location In the 
system»s memory. This location 1s the beginning of the disk 
recovery procedure* a program that copies a new monitor from a 
file stored on the disk* When you type "dskrld<ESC>g"» you tell 
EDDT to go to this procedure and begin running the program found 
there* When the procedure begins* It prints "reloading from 
disk"* If this message never appears* it means EDDT was wiped 
out by the crash and you cannot reach the disk recovery 
procedure. In this case* begin a tape recovery* 
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recovery cannot work without reading the resident monitor from 
disk* you will have to halt the system with Method 3 In section 
13.5 and then use tape recovery to bring the system up. 
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After the resident monitor 1s 1n memoryt the system will go into 
EDDT and print "EDDT" on the operator's terminal. When you type 
■start <£SOg" * you transfer control to the Start procedure. 
This procedure starts up the rest of the recovery procedure and 
copies the swappable monitor from the second part of the monitor 
file. 



the system that after crashing it should stop and wait tor 
Instructions on what to do next. Once the system 1s upf you may 
change these default switch settings with the procedure 
documented in section 12. Recovery Switches. That section also 
explains recovery switches in general. 

Once the system's new monitor 1s 1n place* the remainder of disk 
recovery is exactly the same as tape recovery. Thus* the 
following explanation is identical to the last part of the 
Discussion in the section on tape recovery. This explanation is 
Included here for your convenience; if ycu are already familiar 
with tape recovery* you do not need to read further. 



Now that 1t has 
to the memory a 
the memory and 
"Pad Address Ta 
keep track of w 
be used. Once 
and should not 
called "CHECKDI 
the disks and t 
that no section 
and that all f1 
errors in the f 
system stops an 
the system will 
haoDenlng it w1 



its new monitor* 
nd file system* 
tells you about t 
ble" # BAT blocks 
hat parts cf the 
It Is determined 
be used for stora 
SK". CHECKDISK* 
he Integrity of t 

of the disk is a 
le addresses are 
1le system* it 11 
d waits for you t 

not be able to c 
11 announce* "Aug 



the system turns its attention 
It first reports on the size of 
he BAT blocks. "BAT" stands for 

contain tables that are used to 
disk are bad and thus should not 
what parts of the disk are bad 
ge* the system runs a program 
as the name indicates* checks 
he file system It makes sure 
llocated to more than one file 
valid. If CHECKDISK discovers 
sts the bad files* and the 
o correct them. In this case, 
ome up? to let you know what is 
ust not in operation". For more 



6 Disk Recovery Page 20 

Information on CHECKDISK and Instructions for correcting the 

errors 1t detects* see section 13.2* Correcting Problems Found 
by CHECKCISK. 
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directs you to enter the current date and tims* type two numbers 
for the day* a dash* the first three letters of the month* a 
dash* and then two numbers for the year. Follow these with a 
space and then give the time* on a 24 hour basis* as two numbers 
for the hour* a colon* and then two numbers for the minutes? be 
sure to give the correct time. Follow all this with a carriage 
return. For example* you would enter the date March ?* 1981* 
and the time 5:04 pm* as "G9-Par-8KSP>17:04<CR>" . If you enter 
the wrong date and time* finish the recovery procedure and then 
correct your mistake as documented in section 13*6* Changing the 
Date and T 1me. 

After you have entered the date and time the system is 
officially up. The system jobs will now log in automatically 
and you will be prompted with "9"* the prompt for EXEC. This 1s 
an Invitation to log in. Log In as an operator by typinn 
"oper<SP>password<SPXCR>"* that is: "oper" (for operator)* a 
space* your password* a space* and then a carriage return. In 
the interests of secrecy* your password will not print. After 
you have logged 1n* the system will print various messages and 
another "ft". Type *ena<Ch>* • This stands for "enable" and 
tells the system to allow you to perform operations denied the 
normal user. Once you have "enabled"* or identified yourself to 
the system as a person with special powers* the system will 
change its prompt to "!"• Now refuse automatic logout by tyoing 
"ref <SP>a<CR>". AUGUST normally logs out users who leave their 
terminals idle. 

6.4 Errors and Recoveries 

Nothing happens when you type "dskr ld<ESC>g" 

If nothing happens when you type "dskrldCESOg** this means 
the disk recovery procedure cannot be used. Instead* use the 
tape recovery procedure. 

The system cannot find a monitor file 

If the system cannot find the monitor file. 1t will tetl you 
"FAILED TO READ RESIDENT MONITOR". If you have told the 
system to look on a specific disk for the monitor* halt the 
system Cwlth Method B of section 13.5)* try another disk 
recovery and tell the system to look on a different disk for 
the monitor. If* after checking them all (either by typing a 
<CR> or individually giving the number of each disk)* you 
discover that none of the disks have a good copy of the 
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monitor filet you cannot use disk recovery. Halt the system* 
1t necessary* and bring 1t up with a tape recovery. 

Errors before CHECKDISK reports on the file system 

If the system hangs or crashes before CHECKDISK reports on 
the status of the file system and you never get the message 
"August In operation" or "August not In operation"* recovery 
will not be successful* Bring up the system with the tape 
recovery procedure. 

CHECKDISK discovers problems with the file system 

If CHECKDISK finds anything wrong with the file system* the 
System XXV will stop and wait for you to correct the 
problems. It cannot come uo while something 1s wrong with 
the file system? the risk of destroying files is too great. 
For directions on how to correct any problems CHECKDISK 
finds* see section 13.2* Correcting Problems r ound by 
CHECKDISK. 
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AUTOMATIC RECOVERY 



7,1 Introduction 



How a System XXV responds to a crash Is determined by Its 
recovery switches. Recovery switches are explained 1n section 
12* Recovery Switches. If they are set for automatic recovery 
9EF0RE a crasht then* after one occurs* the system should 
immediately try to bring itself up with the procedure documented 
here. This 1s convenient* since you do not have to start a 
recovery procedure every time the system crashes. However* do 
not assume that systems set for automatic recovery will neyer 
need your help. If the crash was due to power failure or 1t 
damaged memory* automatic recovery will never begin? the system 
will simply sit there and you will have to begin a tape 
recovery. If the recovery procedure was somehow damaged 1n the 
crash* the system may start to bring itself uo and then hang or 
crash again. In this case too* you must step 1n» halt the 
system* if necessary* and use tape recovery. Even if automatic 
recovery begins and gets as far as running CHECKDISK* success 1s 
not guaranteed. If CHECKDISK detects problems in the file 
system* automatic recovery can proceed no further. After 
correcting the file problems and halting the system (both 
documented In section 13* Related Procedures)* you will have to 
use disk recovery to orlng the system up. 

7.2 Summary 

If a System XXV set for automatic recovery comes up 
successfully* you do not need to do anything until you log In as 
an operator. If recovery never starts* if it fails before 
CHECKDISK reports on the file system* or if CHECKDISK discovers 
bad files* see "Errors and Recoveries" in this section for 
1nst ruct 1 ons • 

1) The system will begin to bring Itself up? various messages 
will recoro its progress. 

2) CHECKDISK will run and check the file system. If it finds no 
major errors* it will report the number of disk pages used 
and the number available. If bad files are discovered* they 
will be listed and the system will announce "August not 1n 
operation". 

3> If CHECKDISK runs successfully* the system will announce 
"tugust 1n operation". The system is now up. The system 
jobs will log in automatically. 

4) When the system prompts you with "3"* the prompt for EXEC* 
log in by typing "oper <SP>password<SP><CR>"* where password 
stands for your password. 
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5) A^ter system DMnts various messages and prompts with you 
another "<?"* type "en3<"CR>"» The response will be a new 
prompt* "!"• 

6> Type "ref <SP>a<CR>» • 

7.3 Discussion 

When a System XXV crashes* the first thing It does 1s check Its 
recovery switches* the switches which tell it what 1t should do 
next. Recovery switches and their various settings are 
explained In section 12* Recovery Switches* One setting of the 
recovery switches will tell the system to come up automatically* 
If* after a crash* the system discovers that the switches are 
set in this way* it will immediately start to bring itself oack 
up without waiting for an operator. 

There aret however* several problems that can stop systems from 
coming uo automatically* First of all* the system may never 
find out that it was supposed to do this. In crashes due to 
power failure and those that damage memory* the recovery switch 
settings may be lost or never checked* Consequently* a system 
you think 1s set to come up automatically will not* Instead* 1t 
will wait for you to begin a recovery procedure* just as it 
normally does after a crash* Keep an eye on all systems set for 
automatic recovery? if you see a system that appears to be down 
and not trying to come up* you will have to use the tape 
recovery procedure to bring it up* Do not try to use the disk 
recovery procedure? it too will be lost along with the recovery 
switches* 

If the system does remember its recovery switch settings and try 
to come up automatically* it usually begins by copying the 
current contents of central memory into two files* The first 
512 pages of memory are stored in a file called 

<TSYSTEM>CORDMP*LOW and the second 512 pages are stored in a file 
called <SYST r tf>CORDMP*HGH* These files are used by systems 
programmers to find out what was in central memory right after 
the crash* If you do not want the system to bother with this 
copying* you may set the recovery switches so that it will not 
be done* See section 12* Recovery Switches* 

Once the contents of core have been safely stored in the CORDMP 
files* the system next needs a new copy of the monitor* The 
system copies the monitor from disk with a procedure very much 
like the disk recovery procedure* The procedure prints messages 
to help you follow its progress* It is a very good idea to read 
these messages and make sure recovery Is progressing 
successfully* T.ven after the recovery procedure starts* things 
can still go wrong* If the procedure was damaged by the crash* 
the system may hang as 1t comes up or may try to come up* fail* 
and crash again* After crashing* the system would once more 
check the recovery switches* discover It should come up 
automatically* take another core dump* and try to come up- As 
it tried to come up* the system would encounter the same problem 
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and crash again. The system could thus get caught 1n a loop of 
crashing* trying to come up? and crashing again* If you notice 
a system set for automatic recovery that appears to be hung or 
having some kind of trouble* watch 1t for a while. If 1t never 
gets to the point of running CHECKDISK? halt the system with 
method B of section 13.5* Halting the System. Then switch to 
tape recovery. 

If all goes well with the automatic recovery procedure? 1t will 
announce "reloading from disk"? move Itself to a special place 
1n memory? starting at location 3000 and clear the rest of core. 
A new resident monitor Is then copied from a file where 1t 1s 1s 
permanently stored on the disk. After the resident monitor 1s 
read? the system starts up and transfers control to the Start 
procedure. This very much like the procedure you get when you 
give the Start command In the disk recovery procedure. The 
Start procedure starts up the rest of the reocvery procedure and 
copies the swappable monitor from the sscond oart of the MOMITDR 
file. 
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automatic: next time the system crashes It will again try to 
bring Itself up automatically. 

Once the system has found out the time and come all the way ud« 
the system jobs can log 1n automatically and you will be 
prompted with "2% the herald for EXEC* This 1s an Invitation 
to log in. Log 1n as an operator by tyolng 

"oper<SP>password<SPXCR>"* that 1st "oper" Cfor operator)* a 
space* your password* a space* and then a carriage return. in 
the Interests of secrecy* your password will not print. Mter 
you have logged 1n* the system will print various messages and 
another "3". Type "ena<CP>"» This stands for "enable* and 
tells the system to allow you to perform operations denied the 
normal user* Once you have "enabled"* or Identified yourself to 
the system as a person with special powers* the system will 
change Its prompt to "!"• Now refuse automatic logout by tyoing 
"ref <SP>a<CR>"» AUGUST normally logs out users who leave their 
terminals idle. 

7.4 Errors and Recoveries 

The System never begins to bring Itself up 

If a system that is supposed to be set for automatic recovery 
never announces "reloading from disk" to show It has begun* 
bring the system up with tape recovery. 

Errors before CHECKDISK reports on the file system 

If the system hangs or crashes before CHECKDISK reports on 
the status of the file system and you never get the message 
"August 1n operation" or "August not 1n operation"* recovery 
will not be successful. Bring up the system with the tape 
recovery procedure. 

CHECKDISK discovers problems with the file system 

If CHECKDISK finds anything wrong with the file system* the 
System XXV will come up automatically; the risk of destroying 
files is too great. Instead* 1t will stop and wait for you 
to correct the problems. For directions on how to correct 
any problems CHECKDISK finds* see section 13.2* Correcting 
Problems Found by CHECKDISK. 
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3 TAPE RECOVERY 



8.1 Introduction 
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8*2 Summary 



1) Check the BUTtHLT number on the operator's terminal and look 
it up in the 11st of BUGHLTs; 1n addition* note which error 
lights are lit* Record all this information* 

2) If the power has gone off* you must reload the microcode as 
documented in steps 3 through 12* If the power has not gone 
off* skip to steD 13* 

3) Mount the microcode tape on the tape drive* 

4) Put all switches on the control panel off (down)* 

5) Put address switch 32 on (up)* 

6) Put MICRO PROCESSOR STOP on. 
71 Put MICRO PROCESSOR MIPC on. 

3) Put MICRO PROCESSOR CLR momentarily on. 

9) Put MICRO PROCESSOR C0f!T momentarily on. 

10) Put MICRO PROCESSOR MIPC off* 

11) Put MICRO PROCESSOR STOP off. 

12) Put MICRO PROCESSOR CONT momentarily on. The tape should 
spin and then stoD. Remove the microcode tape from the tape 
drive. 
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13) You are now ready to read In the new monitor* Mount the 
monitor tape on the tape drive. CStart here If you do not 
want to toad the ml crocode .3 

14) Put all switches on the control panel of f • 

15) Put address switches 24 and 26 on* 

16) Put MICRO PROCESSOR STOP on. 

17) Put MICRO PROCESSOR MIPC on. 

18) Put MICRO PROCESSOR CLR momentarily on. 
1?) Put MICRO PROCESSOR CONT momentarily on. 

20) Put MICRO PROCESSOR MIPC off. 

21) Put MICRO PROCESSOR STOP off. 

22) momentarily put MICRO PROCESSOR CONT on. The tape should 
spin and then stop. 

23) Put address switches 24 and 26 off. 

24) Put address switches 29 and 30 ortm 

25) Momentarily put CONSOLE START on twice. 

26) When the operator's terminal says "EHDT"* type 
"start<ESC>g"» The monitor tape should spin. 

27) Remove the monitor tape from the tape drive. 

28) £fter the system reports the size of the memory* put MI PAR 
ERR STOP and MEM PAR ERR STOP on. The system will print 
several messages about BAT blocks. 

29) CHECKDISK will run and check the file system. If 1t finds 
no major errors* 1t will report the number of disk pages used 
and the number available. Tf bad files are discovered* they 
will be listed and the system will announce "August not 1n 
operation". 

30) If CHECKDISK runs successfully* the system will announce 
"August 1n operation" and ask for the date and time. Enter 
these in the form DD-MON-YY<SP>HH !MM; follow with <CR>. The 
system jobs will log in automatically. 

31) When the system prompts you with "ff"* the prompt for EXEC* 
log in by typing "oper<SP>password<SPXCR>"* where password 
stands for your password. 
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32) After system oMnts various messages and orompts with you 
another "S". type "ena<CR>". The response will be a new 
prompt * 






33) Tyoe "ref <SP>a<CR> "• 



€•3 Discussion 



Although you can bring System XXV up after most crashes slmoly 
by providing 1t with a new monitor* this Is not always true. 
Some crashes* especially those due to power failure* wipe out 
not only the monitor* but also the microcode* Since the 
microcode 1s the Information the microprocessor uses to 
translate the monitor Instruction Into something It can 
understand* when this happens you must begin recovery by reading 
In a tape containing the microcode. Only after the mocrocode 1s 
available can the system correctly read the monitor tape. 



Since a system that does not have access to microcode 
part of the monitor cannot understand any Instruction 
the operator's terminal* to reload the microcode you 
the system Instructions from the control panel. ?oun 
microcode tape on the tape drive and put address swlt 
pushing the switch up* Also* find the row of swltche 
■MICRO" and put the MICRO PROCESSOR STOP and MICRO PR 
MIPC on. You then briefly put on MICRO PROCESSOR CLR 
by then MICRO PROCESSOR CONT. This process tells the 
microprocessor that the address specified through the 
switches 1s where It should look for Instructions on 
next* The address you specify by putting on address 
1s address 10 octal. This 1s the beginning of a tape 
routine which Is permanently stored 1n the memory of 
microprocessor. You now want to tell the mlc.roproces 
execute tMs routine and read the tape containing the 
You do this by putting off MICRO PROCESSOR MIPC and M 
PROCESSOR STOP and puttlnq on MICRO PROCESSOR CONT. 



or any 
s given on 
must give 
t the 

ch 3? on by 
s labeled 
0CESS0R 

followed 

address 
what to do 
switch 32 
-reading 
the 
sor to 

microcode. 
ICRO 



Once the system has read 
has all the Information n 
monitor tape* which conta 
procedure for reading th1 
the microcode tape* EXCEP 
with the address switches 
the control oanel* then p 
on MICRO PROCESSOR STDP a 
again momentarily put on 
CONT. This tells the sys 
Instructions at address 5 
address switches 24 and 2 
Instructions for reading 
Instructions, out MICRO P 
off and again momentarily 
microprocessor will read 
monitor tape? this contal 



the tape containing the microcode* 1t 
ecessary to read the first part of the 
1ns the resident monitor* The 
s tape 1s Identical to that for reading 
T that you specify a different address 
• First put off all the switches on 
ut on address switches 24 and 26* DUt 
nd MICRO PROCESSOR MIPC* and finally. 
MICRO PROCESSOR CLR and MICRO PROCESSOR 
tern 1t should begin executing the 
000 octal* the address soeclfled with 
6. Address 5000 1s the beginning of 
the monitor. To execute these 
ROCESSOR MIPC and MICRO PROCESSOR STOP 

put on MICRO PROCESSOR COMT. The 
Into memory the first part of the 
ns the resident monitor* 



8 Tape Recovery 



Page 29 



Once the 
running, 
hit CONfSO 
140 and s 
procedure 
starts up 
resident 
•EDO!" on 
understan 
recovery 
terminal, 
swappable 



res ident 

When you 

LE START 

tart runn 

beginnin 

the resi 

monitor* 

the oper 

d typed c 

procedure 

The sys 

monitor* 



moni tor 

put on 

twice* 

ing the 

g at th 

dent mo 

the sys 

ator »s 

ommands 

by tyn 

tern wit 

the se 



is in 
addres 
you tel 
proced 
is loca 
nltor. 
tern can 
termina 
* you c 
ing "st 
I begin 
cond pa 



memory* you 
s switches 2 
I the system 
ure it finds 
tion brings 
Because EDD 
now go into 
I to notify 
an start up 
art<es.c>g" o 
running and 
rt of the mo 



want to start it 
9 and 30 and then 

to cio to location 

there. The 
the system alive and 
T is part of the 

EDDT and will print 
you. Since EDDT can 
the rest of the 
n the operators 

read in the 
nitor tape. 



When the system copies the new monitor* the old settings of the 
recovery switches are changed to the default switch settings 
that are part of the new monitor. These default settings are: 
DBUGSW = 1* 2CHKSW =" 0* RELDSU r 1* and CD*?SW = 1. This tells 
the system that after crashing it should stop and wait for 
instructions on what to do next. Once the system is up* you may 
change these default switch settings with the procedure 
documented in section 12* Recovery Switches. That section also 
explains recovery switches in general. 

Now that it has its new monitor* the system turns Its attention 
to the memory and file system. It first checks how much memory 
is physically aval table and reports on the size of the memory. 
Putting on MI PAR FRR stop and MEM PAR ERR STOP tells the system 
to stop if a parity error is encountered 1n central memory or in 
the microcode. The system will next tell you about the BAT 
blocks. W BAT» stands for "Bad Address Table". BAT blocks 
contain tables that are used to keep track of what parts of the 
disk are bad and thus should not be used* Once it is determined 
what parts of the disk are bad and should not be used for 
storage* the system runs a program called "CHECKDISK". 
CHECKDISK* as the name indicates* checks the disks and the 
integrity of the file system It makes sure that no section of 
the disk is allocated to more than one file and that all file 
addresses are valid. If CHECKDISK discovers errors in the fite 
system* it lists the bad files* and the system stcos and waits 
for you to correct them. In this case* the system will not be 
able to come up. Instead* after CHECKDISK runs* the system will 
announce* "August not 1n operation". For more information on 
CHECKDISK and instructions for correcting the errors it detects* 
see section 13.2* Correcting Problems Found by CHECKDISK. 

If CHECKDISK finds no serious file problems* it reports on disk 
use* and then* once it 1s finished* the system will announce* 
•August in operation". At this point* the system 1s comoletely 
ready to come up and open Itself to users. Tt needs only two 
more things from you* the date and time. When the system 
directs you to enter the current date and tims* type two numbers 
for the day* a dash* the first three letters of the month* a 
dash* and then two numbers for the year* Follow these with a 
space and then give the time* on a 24 hour basis* as two numbers 
for the hour* a colon* and then two numbers for fhe minutes* be 
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sure to give the correct time* Follow all this with a carriage 
return. For example* you would enter the date March 9* 1981* 
and the time 5:04 pm* as w O9-mar-8KSP>17:04<CR>" • If you enter 
the wrong date and time* finish the recovery procedure and then 
correct your mistake as documented 1n section 13*69 Changing the 
Date and T 1me« 

After you have entered the date and time the system Is 
officially up* The system 5°°s will now log 1n automatically 
and you will be prompted with *8"» the. orompt for EXEC* This 1s 
an Invitation to log In. Log 1n as an operator by typing 
"oper<SP>password<$PXCR>"» that Is: "oper" (for operator)* a 
space* your password* a space* and then a carriage return* In 
the Interests of secrecy* your password will not print* After 
you have logged In* the system will print various messages and 
another "S"* Type "ena<CP>"* This stands for "enable" and 
tells the system to allow you to perform operations denied the 
normal user* Once you have "enabled"* or Identified yourself to 
the system as a person with special powers* the system will 
change Its prompt to "!"• Now refuse automatic logout by typing 
"ref <'SP>a<CR>"* AUGUST normally logs out users who leave their 
terminals Idle* 



8*4 Errors and Recoveries 
Using an old monitor tape 



You may sometimes have to perform a tape recovery with an old 
monitor tape* for example* when you do not have a copy of the 
current monitor or the current taoe 1s bad* When this 
happens* you can use the resident monitor from an old tape to 
start the system runnln* Once the system 1s up* you can 
switch to disk recovery to replace the old resident monitor 
with a good copy of the monitor taken from disk* The 
procedure Is as follows: 

1) Follow the tape recovery procedure from step 13 through 
25* If there has been a oower* problem* do step 3 
through 25* 

2) When the system types "EPDT" on the operator f s 
terminal* type "dskr ld<ESC>g" to start a disk recovery* 

3) Follow the disk recovery procedure beginning from step 
3* 

Problems reading the microcode tape 



If you cannot read the microcode tape* there 1s a 
problem* Call Tymshare Maintenance* 



hardware 
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Problems reading the monitor tape 

If you cannot read the monitor tape? the microcode may have 
been destroyed. Start the recovery procedure over and begin 
at step 3 by loading the microcode* If you do not succeed* 
call Tymshare Maintenance. 

The Interrupt message 

If you get a message* "Interrupt at. nnn»"» where nnn Is some 
number* try reading both tapes again* If you are 
unsuccessful * call Tymshare Maintenance* 

CHECKDISK 1s ne\/er run 

If the system hangs or crashes before CHECKDISK reports on 
the status of the file system and you never get the message 
"August In operation" or "August not 1n operation"* recovery 
will not be successful* Halt the system* 1f necessary* and 
try the recovery procedure over from step 3* Tf the complete 
procedure does not work on the third try* call Tymshare 
Maintenance* 

CHECKDISK discovers problems with the file system 

If CHCCKDISK finds anything wrong with the file system* the 
System XXV will stop and wait for you to correct the 
problems. It cannot come up while something 1s wrong with 
the file system; the risk of destroylna files 1s too great* 
For directions on how to correct any oroblems CHECKDISK 
finds* see section 13*2* Correcting Problems Found by 
CHECKDISK. 
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STANDALONE RECOVERY 



9.1 Introduction 



Bringing the system up with the standalone recovery procedure 1s 
useful when some error 1n the disk* CHECKDISK* or the system 
Jobs 1s causing the system to crash before 1t can come all the 
way up. During a standalone recovery* the system does not run 
CHECKDISK and the other checking programs that are part of the 
three "normal" recovery procedures* Instead* the system comes 
up without checking itself and* after 1t 1s up« 1s shut to 
normal users? only the person at the operator's terminal is 
allowed in* Standalone recovery 1s risky. Do not bring the 
system up with this procedure unless specifically instructed to 
do so* 

9.2 Summary 

1) Check the BUGHLT number on the operators terminal and look 
1t up in the list of BUGHLTs; In addition* note which error 
lights are lit. Record all this Information. 

2) Follow the procedure for tape recovery (section 8> from step 
13 through step 25* If you suspect there has been a power 
failure* do step 3 through 25 of the tape recovery procedure* 

3) When the operator's terminal says "EDDT"» type "dbugsw/"* 
The system will print either (2ero) or 1. 

4) Type "2<CR>". 

5) Type "start<ESC>g"* The monitor tape should spin* 

6) The system will request the date and time. Enter these as 
DD-MON-YY<SP>HH:MM and follow with <CR>. 

7) You will automatically be logged in as "system"* but not 
enabled. 

9*3 Discussion 

To use standalone recovery procedure* you begin by following the 
tape recovery procedure. But after the system reads the first 
part of the monitor tape and tells you It 1s in EDDT* you do MOT 
type "start<esc>g" ♦ to start the system running and read In the 
rest of the tape. Instead* you work 1n EODT an interactive 
language for debuoglng* EDDT Is part of the resident monitor 
and is used to patch and otherwise manipulate it. Because it 
can change the monitor* EDDT Is a very powerful tool? use it 
with care* 



■9 Standalone Recovery Page 33 



Once the system tells you that you are 1n EDDT* do not wait to 
be prompted* EDDT has no prompt; as you use it* it simply waits 
for you to type something and then reacts. When you see that 
are in EDDT* immediately type "dbugsw/". This command has two 
parts. The first partt "dbugsw"* is the name of an address. 
The "/" means "print". Thus* "dbugsw/" instructs the system to 
print what it finds at the location DBUGSW. This location 
contains one of the system's recovery switches* the debugging 
switch. The number at this address tells the system what it 
should do when it encounters a fatal error. A zero (0) at 
DBUGSW means the system should respond to errors by crashing. A 
1 means the system should take breakpoints? that is* when a 
fatal error occurs the system should not crash but should stop 
where it is* preserve the context of the error* and print out a 
BUGHLT address. T his address is what you record after a crash 
when you are instructed to record the BUSHLT number. Knowing 
the address of the error that caused the system to crash helps 
systems programmers find out what happened. Recovery switches 
are further explained in section 12* Recovery Switches. 

After you print the current contents of D3UGSW* type "2<CR>. 
""his tells the system to enter 2 at this location. When DBUGSW 
is 2* it instructs the system to skip running CHECKDISK and the 
system jobs* and to come up "standalone". When a system comes 
up standalone* it accepts input only from the operator's 
terminal* it does not allow any ordinary users to log in. 
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complicated login procedure. When you are logged in as 
"system"* you have the same powers as if you had logged i 
"operator"; remember to enable if you want to do anything 



in as 
requiring special powers. 
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10 DISK REBUILD STRATEGY OR TOTAL CATASTROPHE 

10.1 Introduction 

Occasionally* a particularly deadly system crash destroys the 
file system* If you suspect this has hapoened* immediately 
notify your manager and* if possible* an GAD operating systems 
programmer? do not attempt to do more. 

When the file system is destroyed, you must use the various 
dumps made each week to rebuild the disk and restore the files 
as completely as possible to their pre-crash state. This must 
be finished before the system needs anything from the disk. 
Rebuilding the disk is a fairly simple procedure* but the loss 
of users* files and the Dossibllity that they may be damaged or 
incompletely restored is so serious that you should NEVER 
undertake a disk rebuild without specific Instructions and 
assistance of a manager or an operating systems programmer. 

10.2 Summary 

WARNING: Never attempt this without specific Instructions from 
a manager or an operating systems programmer. 

1) Check with Tymshare Maintenance to make sure the hardware is 
good. 

2) Follow the tape recovery procedure from steps 13 through 25. 
If there has been a power failure* do steps 1 through 25. 

3) When the operator's terminal says "EDDT"* type "dbugsw/". 
The system will print either zero CO) or one CD. 

4) Type "2<CR>". 

5) Type "syslod<ESC>g". 

6) The system will ask* "Do you really want to clobber the disk 
by reinitializing?". 

7) Type "y<CR>". This stands for "yes". Do not type more than 

8> The system will say* "OK* You asked for It..." 

9) The system will reinitialize all the files and then report* 
"No EXEC", 

10) Load the DLUSER tape on the tape drive. 
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11) Type "l"« for "load". When the system asks* "Load from 
magtape MTAN:»* tyoe "mtaO:<CR>" ("0" here Is zero) and 
confirm with another <CR>. 

12) When the system asks* "File Number?"* type "0<CR>". 

13> T he system will now read the DLUSER fil?* the first part of 
DLUSER taoe. 

14) When it has finished* the system will prompt you with a 
period (•)♦ the prompt for MINI-EXEC. At the period* type 



15) The system will print* "Interrupt at nnn"* where nnn is some 
number, followed by a period. 

16) To read the second file in the tape* the DUMPER file* type 
"I"* for "load". When the system asks* "Load from magtape 
MTAN:"* type "mtaO:<CR>"* and confirm with another <CR>. 

17) When the system asks* "File Number?"* type "1<CR>". 

18) The system will now read the DUMPER file. 

19) When the system prompts you with a period* type "s.". 

20) The program DUMPER is now loaded and ready to start 
restoring the files. Mount the first Full Dump Tape. Make 
sure you load the Full Dump Tapes in numerical order. 

21) DUMPER will now ask a series of questions* preceding each of 
them with instructions. 

22) To answer t.he first question* "DUMP* LOAD* CHECK* OR 
SINGLf?"* type "I"* for "load". 

23) For the second question* "DO YOU WISH TO SUPERSEDE OLDER 
VERSIONS ALWAYS?"* type "n"* for "no". 

241 When TUMPER asks* "SPECIFIC USERS?"* type "n". 

25) When it asks* "INTO SAME DIRECTORIES?"* type "y". 

26) Finally* when requested* "TYPE PAG TAPE UNIT NUMBER", type 
"0" (zero). 

27) DUMPER will now read the tape; when it is finished* it will 
print* "MOUNT NEXT TAPE* IF ANY. TYPE C* WHEN READY* N* IF 
MO MOR r ". Mount the next tape and type "c". 



10 Disk Pebuild Strategy or Total Catastrophe Page 36 



29) DUMPER will again ask for the mac tape unit number; type 
"0". 

29) Continue mounting and Loading Full Dump Tapes? typing "c" to 
continue and then giving Czero) for mag tape unit number* 
until all the tapes have been read. 

30) When you have finished loading the Full Dump Tapes* begin 
loading the Incremental Dump Tapes. 9e sure that you load 
the Incremental Dump Tapes in chronological order* beginning 
with the one made right after the Full Dump and ending with 
the most recent. 

3D After the system has read the last Incremental Dump T ape* 
when DUMPER says* "MOUNT NEXT TAPE* IF ANY. TYPE C» WHEN 
READY* N* IF NO M0RE" f tyoe "n". 

32) DU M P r R will stop and the system will print an interrupt 
message followed by a period* the prompt for MINI-EXEC. 

33) The files have now been restored as completely as possible. 
Halt the system* and begin a disk recovery. (To halt the 
system use Method A of section 13.5* Halting the System.) 

10.3 Discussion 

A disk rebuild is necessary when a crash destroys the files. 
Since a system that has lost its files cannot be expected to run 
CHECKDISK or the system jobs successfully — these are stored on 
the disk and everything on the disk has been lost — the system 
must be brought up in such a way that it does not need anything 
from its files; in fact* it does not even realize they are lost. 
This means the system must be brought up standalone* since 1n a 
standalone recovery the system skips running the system jobs* 
does not check the file system with CHECKDISK ♦ and does not 
open Itself for normal use. 

Put bringing up the system for a disk rebuild is not a 
completely "normal" example of bringing the system up 
standalone. Aft$r you have set DPUGSW to 2 (to make the system 
come up without checking itself and closed to users)* you do not 
then type "start<ESC>g" to start the system running. Instead 
you type "syslod<ESC>g". This stands for "system load". It 
tells the system to begin running a program that wipes out all 
existing files and then allows you rebuild the entire file 
system with fites cooled from tape. 

When you give the Systod command* the system will ask* "Do you 
really want to clobber the file system?". When you respond "y"» 
for "yes"* it will print* "OK* you asked for it..." and 
reinitialize all the files. When the files have been 
reinitialized* the system will state: "Mo EXEC"* EXEC 
disappears because it was stored on the disk. After informing 
you of EXEC^s disappearance* the system will prompt you with a 
period (.)♦ the prompt for MINI-EXEC. MINI-EXEC is a group of 
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basic commands that are loaded with the monitor. MINI-EXEC has 
two Important features! First* MINI-EXEC recognizes commands by 
their first letter* so you type "I" for "load"t "s" for "start"* 
and so on* and second* 1n MINI-EXEC you must end ?ll simple 
commands that do not ask you for further Information with a 
period for confirmation* 




unrecognizable. When you are again prompted with a period* 
repeat the command you want* If you are giving a command that 
asks you for further information before it Is executed* type 
some random characters 1n answer to the additional question. 
This will cause the command to be aborted and the period will 
reappear • 

fnce you are in MINI-EXEC* you can begin the procedure for 
rebuildinc the disk from backup tapes. Mount the DLUSER tape on 
tape drive zero* and type "I"* for "load". When the system asks 
you* "Load from magtaoe MTAN!"* Identify your drive as "mtaO!" 
and confirm by typing "<CRXCR>". The system will now ask which 
file on the tape 1t should read by printing: "File Number?". 
The number of the DLUSER file* which should be printed on the 
tape casing* Is zero (0). Enter this and follow it with a 
carriage return. 

DLUSER stands for "duap and load users". The DLUSER file 
contains data about all the directories on the system* both the 
user and system directories* and a program that can jse this 
Information to rebuild them. When you type "s."* you Instruct 
the system to run this program. 

When the system has rebuilt the directories* It will print an 
Interrupt message. This means 1t 1s ready to read another file. 
You now want to load the file containing the DUMPER orogram. To 
do this again, type "I"* and then again* when asked* "Load from 
magtape MTANI"* identify your drive as "mtaO:" and confirm by 
typing "<CRXCR>". Next* you will be asked for the file number. 
The file number for the DUMPER file Is one CD? this also should 
be printed on the tape casing. Enter 1 and follow it with a 
confirming <CR>. The DUMPER file contains a program able to 
read files from tape and restore them to the correct 
directories. Once you have loaded DUMPER and typed "s." to 
start 1t» the DUMPER orogram will start running. You can now 
use this program to rebuild the disk by mounting and reading 
back into the system the dump tapes that contain the back-up 
versions of all the files on the disk. 
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To ascertain what it should do* DUMPER will ask you a series of 
questions* Each question is preceded by an explanation of how 
you should answer it. These explanations are designed for 
people using DUMPER for routine maintenance of the file system. 
Do not be alarmed if the answers you are instructed to give here 
do not agree with what the system tells you to do ♦ Disk rebuild 
is not a normal situation. 

T he first thing DUMPER will want to know is what you plan to do. 
To find out* DUMPER will ask: "DUMP. LOAD* CHECK* OR SINGLE?". 
Since you want to load files from tape back into the disk type 
■l"» for "load". Then mount the first Full Dump Tape on the 
tape drive. Full Dump Tapes are tapes made at regular 
Intervals* usually weekly, that contain a record of the entire 
contents of the disk. The first Full Dump Tape contains all the 
information the system needs to run. As you mount this and the 
following tapes on the tape drive* make sure they do not have 
write rings. 

DUMPER now will try to find out what to do with the information 
on the tape. It will first ask "DO YOU WANT TO SUPERSEDE OLDER 
VERSION'S ALWAYS?". Answer with a "n"» for "no". This makes 
sure that DUMPER will put the files from tape and the files 
already on the disk 1n the correct order and pay attention to 
version numbers. DUMBER will then ask "SPECIFIC USERS?". 
TUMPER asks this because it normally restores the files of 
single users whose directories are somehow lost or mutilated. 
Since you want to restore the all the files of every user* type 
"n"* for "no"; and* when DUMPER wants to know! "INTO SAME 
DIRECTORIES?"* type "y". DUMPER f s final request will bet "TYPE 
MAG TAPE UNIT NUMBER". After you type "0"* DUMPER will cooy the 
files from the currently mounted tape Into their directories. 
When 1t has finished* it will print: "MOUNT NEXT TAPE* IF ANY: 
TYPE C WHEN READY* N» IF NO MORE". Load the next full dump 
tape* making sure it does not have a write ring* and type "c"* 
for "continue". When the mag tape unit number 1s requested* 
answer with "0". This new tape will then be read* and DUMPER 
will again ask if you want to go on. Continue loading the Full 
Dump Tapes until all have been read. 

When you have finished loading the Full Dump Tapes* It is time 
to load the Incremental Dump Tapes. Incremental Dump Tapes are 
tapes made every night that contain only files altered during 
the preceding day. As you enter the Incremental Dump Tepi*s« you 
progressively update the files entered from the Full Dump Tapes. 
Enter the Incremental Dump Tapes in chronological order* 
beginning with the tape made right after the full dump* and 
ending with the tape made most recently. Use the same procedure 
you used to load the Full Dump Tapes: mount the tape* type "c"* 
and enter the unit number. When you have loaded the final* i.e. 
the most recent* Incremental Dump Tape* you will have restored 
the files as well as they can be restored. At this point* 
answer "n% for no* to D'JMPER*s question about any further 
tapes. DUMPER then will halt* and the system will print an 
interrupt message followed by a period* the prompt for 
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MINI-EXEC. Wow halt the system (with Method ft of section 13.5* 
Halting the System) and bring it up with a disk recovery* 

10.4- Errors and Recoveries 

Inability to read the DLUSER tape 

If you are unable to read the DLUSER tape* halt the system 
and start the entire procedure over again. 

Inability to read the first Full Dump Tape Cthe tape after the 
DLUSER tape) 
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11 RECOVERY FROM MEMORY PARITY ERRORS 



11*1 Introduction 
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11*2 Summary 



Call Tymshare Maintenance for all parity errors. 
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12 RECOVERY SWITCHES 



12*1 Introduction 

The System XXV has four "recovery switches" tha 
respond to system errors and what to do when It 
switches are actually four locations In the sys 
memory* each controlling a particular aspect of 
response* Every location or switch can have at 
different values* Changing the values, changes 
will do in the particular situation that the sw 
Por example* the switch controlling what the sy 
encounters a PUGCHK* a less serious error than 
set to Czero) or 1 (one). When the switch ha 
the system ignores BUGCHKs* when It 1s set to 1 
crashes when it encounters a PUGCHK* Thus* to 
run as you wish* you simply set each switch to 
value* The rest of this section will help you 
this value may be and teach you how to set 1t* 
"Switches and Their Settings** discusses each o 
switches and what they control* and describes t 
their different settings* The second part* "Ho 
Switch Settings"* explains how to set a switch 
you want* 
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12*2 Switches and Their Settings 

T he System XXV*s four recovery switches are! 

DPUGSW* which controls reaonse to a BUGHLT 

DCHKSW* which controls the response to BUGCHK 

CDMPSW* which tells the system whether or not to take a core 
dump 

RELPSW* which tells the system whether or not to actually 
begin automatic recovery 

The system checks DCHKSW when it encounters a BUGCHK* a 
relatively minor type of error* T he system then immediately 
does as this switch instructs it? no other switches are looked 
at* When the system encounters a BUGHLT* a fatal error* it 
checks DBUGSW. DBUGSW may then tell it to check the two 
remaining switches* CDMPSW and RELDSW. If DBUGSW does not 
instruct the system to look at CDMPSW and RELDSW* they are never 
checked* 



The table below outlines the values each recovery switch can 
have and the effect of setting the switch to this -value* The 
first column gives the name of the switch* the second column 
lists the possible values for this switch* and the third column 
describes how the system will act when the switch has this 
value* The "normal" value for each switch is marked with a 
stars (*) • When all switches have their normal values* the 
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system prints messages at BUGCHKs* and crashes at BUGHLTs. 
After the system crashes* It will wait for an operator to bring 
It UDt If you want the system to recover automatically* rather 
than wait for operator's Inst ruct ions* simply change the setting 
of DBUGSW from 1 to 0* See the next section for instructions. 



Switch 



Value 
(*=normal ) 



Effects 



HBUGStf Stop at BUSHLTs* check CDM»SW and SFLDSW and 

do what they say. CFor Automatic Recovery) 

1* Stop at BUGHLTs* don't check CDNPSW and RELDSW* 
go into EDDT* and wait for an operator to 
begin recovery. CFor Disk or Tape Recovery) 

2 Stop at BUGHLTs* don't check CDMPSW and RELDSW* 

go into EnDT. Don't run system-checking programs 
and come up shut* (For Standalone Recovery) 

DCHKSW 0* Don't stop at BUGCHKs* print error message and 

continue. 

1 Stop at BUGCHKs* print error message* go into 

EDDT* and wait for an operator to begin recovery* 

CDWPSW Don't take core dump before beginning recovery. 

1* Take core dump before beginning recovery. 

RELDSW Don't begin automatic recovery after crashing. 

1* Begin automatic recovery after crashing. 



12.3 Switch Descriptions 

DBUGSW: DBUGSW* located at memory loc 
the system checks when it encounters a 
BUGHLT is a serious system error. The 
BUGHLT occurs? this switch determines 
the crash* DBUGSW can be set to 0* 1* 
the setting for automatic recovery. I 
check the switches CDMPSW and RELDSW a 
will tell 1t whether a core dump shoul 
tell the system whether to actually st 
below and the section on automatic rec 
at DBUGSW is the standard setting. W1 
encountering a BUGHLT* the system stop 
a BUGHLT message* goes into EDDT* and 
from the operator's terminal. You can 
recovery Drocedure is appropriate. A 
effect as a 1* and* in addition* after 
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then begin whatever 
2 at DBUGSW has the same 
a recovery procedure Is 
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started* causes the system to come up standalone. The system 
will come up without running CHECKDISK and the system jobs and* 
after 1t 1s up* only the person at the operators terminal is 
allowed access* CTo do a standalone recovery* you put a 2 in 
DBUGSW before the system comes all the way up.) 

OCHKSW: DCHKSW* located at memory address 77* 1s the only 
switch checked when the system encounters a BUGCHK* no other 
switches are consulted. DCHKSW can be set to or 1. When 
DCHKSW 1s 0* the system will print out a BUGCHK message and then 
continue running. When OCHKSW 1s 1* the system will print out a 
BUGCHK message and then stop* go Into EDOT* and wait for further 
Instructions about how to come up. Since BUGCHKs are not 
serious errors* the usual setting for DCHKSW is 0. 

CDMPSW: CDMPSW is located at memory address 100. It is checked 
only when a PUGHLT occurs and the system finds that DPUSSW is 
set to zero* the setting for automatic recovery. CD*PSW tells 
the system whether or not to make a copy of the contents of 
central memory before beginning to come up. The process of 
copying the contents of memory is called "taking a core dump". 
If CDIiPSW switch is set to 0* then the system will not take a 
core dump. It will simply check RELDSW to see 1f 1t really 
should come up automatically. If CD^PSW 1s set to 1* before 
checking RELDSW* the system will copy system first 512 pages of 
memory Into a' file called <SYSTEK>COPDMP.LOW and the second 512 
pages Into a file called <SYSTEM>CORDMP*HGH* Since systems 
programmers may need to look at the contents of the memory tD 
Investigate the crash* CDMPSW 1s generally set to 1. 

RFLDSW: RELDSW is located at memory address 101. It* like 
CDHPSW* is checked only after a BUGHLT occurs and DBUGSW set to 
zero* the setting for automatic recovery. RELDSW tells the 
system whether or not It should actually begin this automatic 
recovery. A in RELDSW tells the system not to recover 
automatically; the system will then wait for instructions from 
the operator's terminal just as if DPUGSW were set to 1. A 1 
tells the system "yes* do begin to come up automatically". 
Because when DBUGSW is you usually do want the system to 
recover automatically* the normal setting of RELDSW is 1. 

12.4 How to Change Switch Settings 

Introduct ion 

This section tells you how to change the values of the System 
XXV*s four recovery switches. To do this the system must be 
running correctly and you must be able to enable. To learn 
the names of the recovery switches* their values* and what 
they mean* see the previous section. 
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Suwiary 



1) Check your prompt. If 
are enabled. If 1t 1s 

■£". 



1t Is an exclamation mark <!)* you 
not* type »ena<CR>" at the FXZZ 



2> At, the "!" promptt type "mddt<C»>". 

3> Tyoe "sw1 tchname/"* where swltchname stands for the name 
of the switch you want to change. 

4> The system will give you the current value of the switch. 

5) Type "sw1 tchvalue<CR>"» where swltchvalue stands for the 
new value the switch should have: 0* It or 2. 

6) To check the new value* type "swltchname/" again. The 
system should show you the new value. 

7) Type "<CTRL-C>"; you should return to *"XEC and get the "!" 
prompt » 



Discussion 
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the values of the recovery 
DDT an Interactive language 
he resident monitor and 1s u 
e 1t. To enter MDDT* you f1 
nabled. Check your prompt* 
you are enabled* If 1t 1s 
at EXEC "3" prompt. After 
enter MDDT by typing "mddt<C 
dt"t to show you have entere 
ke EDDT* MDDT has no herald; 
Its for you to tell 1t somet 



switches* you need to 
for debugging* It Is 
sed to change and 
rst need to make sure 
1f 1t 1s an exclamation 
anything else, type 
you are sure you are 
R>". The system will 
d* and then do nothing 

as you use 1t* 1t 
hlng and then reacts. 



When you are 1n KODT. to go to the switch you want to change 
and look at Its current value, type the switch name followed 
by a slash (/)* for example* "dchksw/". This command has two 
parts. The first part* "dchksw"* Is the name of the address 
that contains the recovery switch value. The "/" means 
"print". Thus* "dchksw/" Instructs the system to show you 
the contents of the location "dchksw". 



Once MDDT has shown you the value of the switch* 1t waits at 
this location to see 1t you want to do anything else. If you 
decide you do not want to change this switch* slmoly type a 
carriage return. To enter a different value in this address* 
type the value you want followed by a carriage return* The 
number you type will Immediately become the new value of the 
switch. t make sure that you entered the value you wanted* 
again type the switch name followed by a slash* If the value 
1s correct* simply type a carriage return* This means you 
are finished working with this address. If 1t 1s not 
correct* type the correct value and then a carriage return. 
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After you have chanqed as many of the four recovery switches 
as you wish* you are ready to leave MODT. To do this* type 
<CTRL-C> and you will returned to EXEC» 
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13 RELATED PROCEDURES 

13.1 Introduction 

This section describes the following procedures. 

Correcting Problems Found by CHECKDISK* section 13.2 

Running CHECKDISK Yourself from EXEC* section 13.3 

Deleting and r xpung1ng Mies* section 13.4 

Halting the System* section 13.5 

Changing the Date and Time* section 13.6 

Connecting to and Disconnecting from the PHcronode TYKBASE* 
section 13.7 

When a recovery process requires that one of these procedures be 
used* you will be referred here. If you find that you never 
have to use any of them* do not be alarmed. This 1s a sign of 
success. These procedures are used only when something goes 
wrong — when* for example* CHECKDISK finds file problems that 
must be corrected* you need to halt the system* or the systen 
some how comes up with the wrong date and time. 

13.2 Correcting Problems Found by CHECKDISK 

Introduct 1on 

CHECKDISK Is a program the system uses to check the file 
system before 1t comes all the way up and opens Itself to 
users* If 1t finds any problems* the system states* "August 
not 1n operation" and stops to waits for them to be corrected 
with the procedure documented below. Once this 1s done* halt 
the system as documented later 1n "Related Procedures"* and 
then bring 1t up again with disk recovery. This section 
deals only with recovery from file errors detected by 
CHECKDISK. It assumes that CHECKDISK has Qeen run 
automatically. To learn how to run CHECKDISK manually* see 
13.3* Running CHECKDISK Yourself from EXEC. 

Summary 

CHECKDISK checks the files for Illegal Disk Addresses CIDAs)* 

Multiple Disk Addresses (MDAs> and Bit Table Errors CB^Es). 

If 1t finds any of these* 1t lists the files Involved and 

their errors. To correct the problems found by CHECKDISK do 
the following: 



1) If only one file has errors* delete and expunge that 
Be sure to type the entire file name* Including all 
extensions* do not use <ESC> to fill out names. The 



file. 
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process of deleting and expunging files 1s described In 
section 13.4* Deleting and Expunging Files. 

2) If more than one file Is involved? delete and expunge all 
files with IDAs. Do not delete the files with *DAs at 
this point* 

3) Halt the system with Method A of section 13.5* Halting the 
System. Then bring 1t up again with disk recovery. If 
CHECKDISK again finds files with IDas* repeat this 
procedure. 

4) Once no files have IDAs* 1f one or more files have MD4s» 
delete and expunge the file with the largest number of 
MDAs* halt the system* and bring it up with disk recovery. 
Do this three times. If you then still have more than 20 
files with PDAs* call an operating systems programmer. 

N0T£: Keep a 11st of the files you delete and expunge* and 
restore them after the system comes up. Always send 
messages to all users whose files have been deleted and 
restored. 

D1 scusslon 

CHECKDISK can detect three types of errors: Bit fable Errors 
(BTEs)t Illegal Disk Addresses CIDAs)* and Multiple Disk 
Addresses (MDAs). CHECKDISK can correct ETEs without 
assistance. It cannot* however* correct IDAs or «DAs. These 
two errors are what are known as Page Table Errors. They 
occur when the system's file map* stored in what is called a 
■page table"* is incorrect. AUGUST memory 1s divided into 
units called pages* each consisting of 512 words. Pile 
storage is allotted by pages* and one page 1s the smallest 
unit of storage that can be transferred from disk to core. A 
page table is like a table of contents for the disk storage. 
F or each file* it records the addresses of alt the pages 
allocated to that file.) An IDA means there is a disk 
address that is garbage. An MDA means the system has 
assigned the same part of the disk to two or more files. If 
these errors are allowed to go uncorrected* they can destroy 
the file system. 

The remedy for problems detected by CHECKDISK 1s to delete 
the files that really do have bad storage addresses. If 
there is only one file with bad addresses* there is not a 
serious problem? simply delete that file. If more than one 
file is afflicted* begin by deleting all files with IDAs. 
IDfis are' a frequent cause of MDAs. Often* when the system 
follows an IDA« 1t will find other things that it can 
interpret as more addresses* but which are not. T hese phony 
addresses may duDlicate the real addresses of pages belonging 
to other files* thus causing MDAs. After IDAs are taken care 
of* files with MDAs may remain. Deleting the single file 
with the most MDAs may take care of the problem. 
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Dnce you have deleted the appropriate files* you should halt 
the system and bring it back up with disk recovery. If 
CHECKDISK again finds errors* you must again correct them* 
bring the system down* and then back up. If the fourth time 
CHECKDISK is run it still finds errors* notify an CAD systems 
programmer. Remember that once the system does come up 
successfully* the owners of the files must be notified about 
all files deleted. 

13.3 Running CHECKDISK Yourself from EXEC 

Introduction 

CHFCKDTSK is a program that checks the address system and 
page allocation of the disk. CHECKDISK usually runs 
automatically as the system comes up. However* there may be 
occasions* for example after a standalone recovery* when you 
need to run CHECKDISK yourself. This section documents that 
procedure. What CHECKDISK does is explained in section 13.2* 
Correcting Errors Found by CHECKDISK. 

Nummary 

1) At the EXEC "5"* type "<system>checkdisk<ESCXCR>". 

2) When CHlCKDISK asks* "Do you want to run in multiole fork 
mode?"* type "Y»* for yes". All answers to CHECKDI?K f s 
question must be capitalized. Do not type more than a 
single letter* since CHECKDISK will take any excess 
letters as answers to following questions. 

3) When CHECKDISK asks* "Do you want to run backwards?"* type 

■«"♦ for not / 

4> To the Question: "Rebuild the bit table?"* type "N". 

55 To the Question: "Scan for disk addresses?"* type "N". 

6) CHECKDISK will now check the disk for bad files. For 
instructions on how to deal with bad files* see section 
13.2. 

Discussion 

You invoke CHECKDISK by typing "<system>checkd isk<ESC><CR>". 
Once CHECKDISK is loaded* it will ask you a series of 
questions to determine how the disk should be checked and how 
much information about its status you want to get and store. 
When CHECKDISK runs automatically* these options are already 
specified; however* when you run CHECKDISK manually* you must 
specify them y6urself. 

The first question CHECKDISK will ask is* "Do you want to run 
in multiple fork mode?". This means* "Do you want to fire up 
a different fork of EXEC to run CHECKDISK seoarately for each 
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disk?"* T he standard answer here Is "Y"* for "yes"* since 
runnina CHECKDISK simultaneously on all the disks 1s faster 
than going through the disks one at a time. Note that you 
should type only the first letter of your answers to 
CHECKDISK's questions and that this letter must be 
capitalized. This Is important* CHECKDISK cannot recognize 
lowercase letters* Moreover* if you type more than one 
letter* CHECKDISK will read the second and following letters 
as answers to later questions. This can cause a let of 
problems* 
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The CHlCKDISK will then ask if it should scan for disk 
addresses. CHECKDISK wants to know If you want the names of 
the files that are actually associated with all the bad disk 
addresses. Since this Information is useful only to systems 
programmers* answer "N". 

CHECKDISK will now check the disk and print a list of bad 

files and their errors. For instructions on how to deal with 

bad files* see section 13.2* Correcting Problems Found by 
CHECKDISK. 

13.4 Deleting and Expunging Files 

Summary 

1) If your prompt is not an "!•* type "ena<CR>" at the EXEC 



2) Connect to the directory that contains the file by typing 
"cd<SP>di rectoryname<CR>"* where di rectoryname stands for 
the name of the directory you need. 

3) Type "del<SP>f 1lename<CR>" • Make sure you type the entire 
file name including extensions. Do not use <ESC> to fill 
out the name — the file may not be recognized correctly. 
Procede all unusual characters in the file name* for 
example S>* with <CTRL-V>. 



13 Related Procedures 



Page 50 



4) Tf the system tells you the tile 1s peroetual* type 
"not<SP>perD<SP>f llename" and then delete the file. 

5) Type "exp<ESCXCR>" . 

6) Remember to connect back to directory "oper" when you 
finish deleting files by typing "cd<SP>oper<CR>"* 

NOTE: Always send a message to any user whose files you have 
deleted. 

13.5 Halting the System 

Introduction 
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Method A* Halting a Running System from the Operator's Terminal 

This procedure has two steps* First* you need to get Into 
MINI-EXEC* and then you need to halt the system* If you are 
already 1n MINI-EXEC when you decide to halt the system* 
start this procedure on step 4; 1f you are not* start at step 
1. The way to tell 1f you are 1n MINI-EXEC 1s to look at the 
prompt. If 1t Is a period <•>• you are In MINI-EXEC; If 1t 
1s anything else* you are not* 

1> If your prompt 1s not an "!•* type "ena<CR>" at the 
EXEC "3". 

2) Type "qu1t<CR>" 

3) When the system asks* "Do you really want to go Into 
AUGUST monitor? (Confirm)"* type "<CR>". 

5) At the period <•) prompt* type "h"* 

6) The system will echo* "HALT TENEX"* 
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8) The system will halt. 
Method B. Halting the System from the Control Panel 

1) Put address switch 31 on (up). 

2) Put data switch 2 on. 

3) Put console: DEPOSIT THIS on. 

4) Put data switch 2 off. 

5) Put data switch on. 

6) Put CONSOLE DEPOSIT THIS on. 

7) When activity (the flickering of the tiohts* etc.) stops? 
the system has halted. 

13.6 Chancing the Date and Time 
Summary 

1) If your prompt is not an "!"* type "ena<CR>" at the EXEC 

2) When you see the prompt "!"♦ type 
"<CTRL-E>set<SP>DD- M OM-YY<SP>HH:«M<CR>"; that is* two 
numbers for the day* a dash* the first three letters of 
the monthf a dash* and then two numbers for the year. 
Follow this with a space* then give the time on 24 hour 
basis* and end with <CR> You must tyoe the entire date 
and time to reset any part of it. 

3) Type a confirming <CR>. 

4) At the EXEC "S"» type "day<CR>* to check the new date and 
time. 

13.7 Connecting to and Disconnecting from the Micronode TYMBASE 

Introduct ion 

The two sets of procedures documented below allow you control 
whether or not the system will communicate the micronode 
TYMBASE. The ability to control the system's interaction 
with the micronode is useful when some micronode error is 
causino system problems or when the micronode is down and 
the system should not try to connect to it. Each set of 
procedures allows you to do the same things: Turn the 
micronode connection off* which causes the system to 
ignore the micronode; and turn the micronode connection 
on* which tells the system to synchronize with the 
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micronode# Method A and Method B differ in where you give 
the controling commands* Method A uses commands given in 
EXEC. In Method 9* 1n the other hand* you use EDDT. 
Method B should be used only during crash recovery* when 
you must control how the system interacts with the 
micronode as it comes up. In all other cases* control 
interaction from the EXEC with Method A. 

Method A: Controling interaction from FXEC 

To turn off the micronode connection 

1) At the EXEC "8"* type "<CTRL-E>t ymnet<$P>of f <CR>". 

To turn on the micronode connection 

1) At the EXEC "3"* type "<CTRL-E>t ymnet<S»>on<CR>". 

Method B! Controling interaction from EODT 

To turn off the micronode connection 

1) In EDDT* type "tymflg/". 

2) After the system prints a value* type "0<CR>". 
To turn on the micronode connection 

1) In EDDT* type •tymflg/". 

2) After the system prints a value* type "-1<CR>"« 
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APPENDIX 

This section is designed for Quick reference? use it when you need 
to look up a certain step in a procedure* cannot remember 
exactly what order to do things* and so forth. tio explanations 
of when to use these procedures* discussions of what they do* or 
suggestions about what to do if things go wrong ere included 
here. For this type of information go to the first part of this 
manual where the procedures outlined in this section are 
discussed in creater length. All sections references in this 
appendix are also to earlier sections in this document. 

WHAT TO DO IP THE SYSTEM IS HUNG 

1) Put address switch 31 on (up). 

2) Put data switch 2 on. 

3) Put CONSOLE DEPOSIT THIS momentarily on. 

4) Put data switch on. 

5) Put CONSOLE DEPOSIT THIS momentarily on. 

6) Wait until activity (the flickering of the lights* etc.) 
stops. 

7) Bring the system up with the disk recovery procedure. 

DISK RECOVERY 

1) Record the BU^HLT number and error lights. 

2) Type "dskr ld<ESC>g" • The reponse should be •reloading from 
disk". If you never get this message* begin a tape recovery. 

3) When the system says* "BOOT FROM DISK PACK # CCR FnR ANY}"* 
type <CR>. 

4) When the operator's terminal says "EDDT"* type "st art<ESC>g". 

5) If CHECKDISK runs successfully* the system will announce 
"August in operation" and ask for the date and time. Enter 
these in the form DD-MCN-YY<SP>HH:MM and follow with <CR>. 

6) At the 8 prompt* log in by typing "oper<SP>password<SPXCR>"» 
where password stands for your password. 
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7) Type "ena<CR>". 

8) Type "ref <SP>a<CR>" • 

AUTOMATIC RECOVERY 

If a System XXV set for automatic recovery comes up 
successfully* you do not need to do anything until you log in as 
an operator* 

1> At the a prompt* log in by typing "oper<SP>password<SPXCR>"* 
where password stands for your password. 

2) Type "ena<CR>". 

3) Type "ref <SP>a<CR>". 

TAPE RECOVERY 

1) Record the BUGHLT number and error lights. 

2) If the power has gone off* you must reload the microcode as 
documented in steps 3 through 12* If the power has not gone 
off* skip to step 13. 

3) Mount the microcode tape on the tape drive. 

4) Put all switches on the control panel off (down). 

5) Put address switch 32 on (up). 

6) Put MICRO PROCESSOR STOP on. 
7> Put MICRO PROCESSOR MIPC on. 

8) Put MICRO PROCESSOR CLR momentarily on. 

9) Put MICRO PROCESSOR CONT momentarily on. 

10) Put MICRO PROCESSOR MIPC off. 

11) Put MICRO PROCESSOR STOP off. 

12) Put MICRO PROCESSOR CONT momentarily on. The taoe should 
soin and then stop. Remove the microcode tape from the tape 
drive. 
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13? You are now ready to read In the new monitor* Mount the 
monitor tape on the taoe drive* CStart here 1f you do not 
want to load the microcode. 1 

14) Put all switches on the control panel off. 

15) Put address switches 24 and 26 on. 

16) Put MICRO PROCESSOR STOP on. 

17) Put MICRO PROCESSOR MIPC on. 

13) Put MICRO PROCESSOR CLR momentarily on. 
l«n Put MICRO PROCESSOR CONT momentarily on. 

20) Put MICRO PROCESSOR MIPC off. 

21) Put MICRO PROCESSOR STOP off. 

22) Momentarily put MICRO PROCESSOR CONT on. The tape should 
spin 3nd then stop. 

23) Put address switches 24 and 26 off. 

24) Put address switches 29 and 30 on m 

25) Momentarily put CONSOLE START on twice. 

26) When the operator's terminal says "EDDT"* type 
"start<ESOg". 

27) Remove the monitor tape from the tape drive. 

28) After the system reports the size of the memory* put MI PAR 
ERR STOP and MEM PAR ERR STOP on. 

2°) If CHECKDTSK runs successfully* the system will announce 
"August 1n operation" and ask for the date and time. Enter 
these in the form DD- m 0N-YY<SP>HH:MM and follow with <CR>. 

30) fit the a prompt* log in by typing 
"oper<SP>password<SPXCR>" * where password stands for your 

password. 

31) Type "ena<CR>". 

32) "yve "ref <SP>a<CR>". 
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STANDALONE RECOVERY 

1) Record the BUGHLT number and error lights. 

2) Follow the procedure for tape recovery (section 8) from step 
13 through step 25* If you suspect there has been a power 
failure* do step 3 through 25 of the tape recovery procedure. 

3) When the operator r s terminal says "EDDT"* type "dbugsw/". 

4) Type "2<CR>". 

5) Type "start<ESC>g". The monitor tape should spin* 

6) The system will request the date and time. Enter these 1n 
the form DD-*ON-YY<SP>HH:WM and follow with <CR>. 

7) You will automatically be logged in as "system"* but not 
enabled. 



DISK REBUILD STRATEGY CR TOTAL CATASTROPHE 

WARNING: Never attempt this without specific instructions from 
a manager or an operating systems programmer. 

1) Check with Tymshare Maintenance to make sure the hardware 1s 
good. 

2) Follow the tape recovery procedure from steps 13 through 25. 
If there has been a power failure* do steps 3 through 25. 

3) When the ooerator^s terminal says "EDDT"* type "dbugsw/". 
4> Type "2<CR>". 

5> Type "sys lod<ESC>g" • 

6) When the system asks* "Do you really want to clobber the disk 
by reinitializing?"* type "y<CR>". 

7) Load the DLUSER tape on the tape drive. 

8> Type "I"* for "load". When the system asks* "Load from 

magtape M^an:"* tyoe "mtaO:<CR>" ("0" here 1s zero). Confirm 
this with another <CR>. 

9) When the system asks* "File Number?"* type "0<CR>". 
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10) When the system has read the DLU^ER file and prompts you 
with a period (•)* tyoe "s.". 

11) When you see "Interrupt at nnn"t where rmn is some numbert 
type "l"» for "load"* then specify "mtaOt<CR>"» and confirm 
with another <CR>. 

12) When the system asks* "File Number?"* type "1<CR>". 

13) At the period prompt? type "s.". 

14) Mount the first Full Dump Tape* Make sure you load the Full 
Dump Tapes in numerical order* 

15) To DUMpr=?t s question* "DUMP* LOAD* CHECK* OR SINGLE?"* tyoe 
"l"» for "load"* 

16) For the second question* "DO YOU WISH TO SUPERSEDE OLDER 
V r RSI0KS ALWAYS?"* type "n". 

17) For the question* "SPECIFIC USERS?"* type "n". 

18) To answer* "INTO SAME DIRECTORIES?"* type "y". 

19) When requested* "TYPE MAG TAPE UNIT NUMBER"* type "0" 
f zero) • 

20) DUMPER will now read the tape; when it is finished* it will 
print* "MOUNT NEXT TAPE* IF ANY. TYPE C» WHEN READY* N* IF 
NO MORE". Mftunt the next tape and type "c". 

21) When DUMPER asks for the mag tape unit number? type "0". 

22) Continue mounting and loading Full Dump Tapes* typing "c" to 
continue and then giving (zero) for mag tape unit number* 
until all the tapes have been read. 

23) When you have finished loading the Full Dump Tapes* begin 
loading the Incremental Dump Tapes. Be sure that you load 
the Incremental Dump Tapes in chronological order* beginning 
with the one made right after the Full Dump ami ending with 
the most recent. 

24) After the system has read the last Incremental Dump Tape* 
when DUMPER says. "MOUNT NEXT TAPE* IF ANY. TYPE C* WHEN 
READY* N» IF NO MORE"* type "n". 

25) When you see an interrupt message followed by a period* halt 
the system* and begin a disk recovery. CTo halt the system 
use Method A of section 13.5* Halting the System.) 
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CHANGING RECOVERY SWITCH SETTINGS 

1) It your prompt is not an "!"* type "ena<CR>" at the ZXEC "8". 

2) At the ■!" prompt* type "mddt<CR>". 

3) Type "swit chname/"* where switchname stands tor the name ot 
the switch you want to change* 

4) Type "switchvalue<CR>" • where swltchvalue stands tor the new 
value the switch should have: Ot If or 2. 

5> Type "<CTRL-C>" to return to EXEC. 

CORRECTING PROBLEMS FOUND BY CHECKDISK 

1) If only one tile has errors* delete and expunge that file. 
Be sure to type the entire file name. 

2) If more than one file is involved, delete and expunge all 
files with IDAS. Do not delete the files with MDAs at this 
point • 

3) Halt the system with *ethod A of section 13.5 and bring it up 
with disk recovery. If CHECKDISK again finds files with IDAs* 
repeat this procedure. 

4) Once no files have IDAs* if one or more files have MDAs. 
delete and expunge the file with the largest number of MDAs* 
halt the system, and bring it uo with disk recovery. Do this 
three times. If you then still have more than 20 files with 
MDAs* call an operating systems programmer. 

NOTE: Keep a list of the tiles you delete and expunge* and 
restore them after the system comes up. Always send messages to 
all users whose files have been deleted and restored. 

RUNNING CHECKDISK YOURSELF FROM EXEC 

1) At the EXEC "SI"* type "<system>cbeckdisk<ESCXCR>" • 

2) When CHECKDISK asks* "Do you want to run in multiple fork 
mode?"* type "Y"* tor yes". All answers to CHECKDISK*s question 
must be capitalized and one letter. 

3) To the question* "Do you want to run backwards?"* type "N"* 
for no. 
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4) To the question: "Rebuild the bit table?"* type "N". 

5) To the question: "Scan for disk addresses?"* type "N". 

6> CHECKDISK will check the disk for bad files. For 
Instructions on how to deal with bad files* see section 13.2. 

DELETING AND EXPUNGING FILES 

1) If your prompt 1s not an "!"* type "ena<CR>" at the EXEC "2". 

2) Connect to the directory that contains the file by typing 
"cd<SP>d1 rectoryname<CR>"* where dlrectoryname stands for the 
name of the directory you need* 

3) Type "del<SP>f 1lename<CR>" • Make sure you type the entire 
file name Including extensions. Do not use <ESC> to fill out 
the name ~ the file may not be recognized correctly. Procede 
all unusual characters 1n the file name* for example St with 
<CTRL-V>. 

A) If the system tells you the file 1s perpetual* type 
"not<SP>perp<SP>f 1 tename" and then delete the file. 

5) Type »exp<ESCXCR>" . 

6) When you finish deleting files* type " cd<SP>oDer<CR>" • 

MOTE; Always send a message to any user whose files you have 
de let ed. 

HALTING THE SYSTEM 

Method A. Halting a Running System from the Operator's Terminal 

This procedure has two steps. First* you need to get Into 
MINI-EXEC* and then you need to halt the system. If you are 
already In MINI-EXEC when you decide to halt the system* 
start this procedure on step 4? if you are not* start at step 
1. The way to tell 1f you are 1n MINI-EXEC 1s to look at the 
prompt. It 1t 1s a period (.)* you are In MINI-EXEC; If 1t 
1s anything else* you are not. 

1) If your prompt 1s not an "!"* type "ena<CR>" at the 
EXEC "S»". 

2) Type "qu1t<CR>" 

3) Uhen the system asks* "Do you really want to go Into 
AUGUST monitor? (Confirm)"* type "<CR>"« 

5) At the period (•> prompt* type "h". 
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6* The system will echo, "HALT TENEX". 

7) ""ype "•"• 

8) T he system will halt* 

Method B. Haltino the System from the Control Panel 

1) Put address switch 31 on (up). 

2> Put data switch 2 on. 

3) Put CONSOLE DEPOSIT THIS on, 

4> Put data switch on. 

5) Put CONSOLE DEPOSIT THIS on. 

6) When activity (the flickering of the lights, etc.) stops; 
the system has halted. 

CHANGING THE DATE AND TIME 

1) If your prompt Is not an "f", type "ena<CR>" at the EXEC *3". 

2) When you see the prompt "!", type 
"<CTRL-E>set<SP>DD-MON-YY<SP>HH:MM<CR>*; that 1st two numbers 
for the day, a dash, the first three letters of the month, a 
dash, and then two numbers for the year* Follow this with a 
space and then give the time on 24 hour basis. You must type 
the entire date and time to reset any part of it. 

3) Type a confirming <CR>« • 

4) At the EXEC "?", tyne "day<CS>" to check the new date and 
time. 

CONNECTING TO AND DISCONNECTING FROM MICRONODE TYMBASE 

Method A: ControUng Interaction from EXEC 

To turn off the mlcronode connection 

1) At the EXEC "3", type "<CTRL-E>tymnet<SP>of f <CR>" • 

To turn on the micronode connection 

1) At the EXEC "S", type "<CTRL-E>tymnet<SP>on<CR>" . 
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Method B! ControUng Interaction from EDDT 
To turn off the mlcronode connection 

1) In EDDT» type "tymflg/". 

2) After the system prints a value* type "0<CR>" 
To turn on the mlcronode connection 

1) In EDDTt type "tymftg/". 

2) After the system prints a value* type "-1<CR> 
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